Live2D Assistant

by wwbweibo

11 stars

304 downloads

Not rated

GitHub

About

Live2d Assistant is an extensive assistant application with mcp server and multi-agent support.

Details

Author: wwbweibo
GitHub stars: 11
Downloads: 304
Categories: AI

- Custom Live2D models with adjustable position, scale, and background.
- Multi-LLM integration (Qwen, OpenAI, Gemini, etc.) with context-aware conversations.
- Multi-agent system using Router Agent and expert agents for task delegation.
- Web (Vite+Vue3) and Electron desktop support, switchable in one codebase.
- Rich settings including assistant name, system prompt, model parameters, and background.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Live2D Assistant

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "live2d assistant": {
            "live2d-assistant": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "live2d assistant": {
            "live2d-assistant": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "live2d assistant": {
            "live2d-assistant": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "live2d assistant": {
            "live2d-assistant": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "live2d assistant": {
            "live2d-assistant": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "live2d assistant": {
            "live2d-assistant": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "live2d assistant": {
            "live2d-assistant": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "live2d assistant": {
            "live2d-assistant": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "live2d assistant": {
            "live2d-assistant": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "live2d assistant": {
            "live2d-assistant": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "live2d assistant": {
            "live2d-assistant": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "live2d assistant": {
            "live2d-assistant": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "live2d assistant": {
            "live2d-assistant": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "live2d assistant": {
            "live2d-assistant": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "live2d assistant": {
            "live2d-assistant": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

From the repository

Install the frontend (cd live2d-assistant-fe, npm install, npm run dev), the backend (cd live2d-assistant-server, uv sync, uv run fastapi run main.py), and optionally the Electron desktop app (cd electron-live2d, npm install, npm run start). The frontend dev server runs on localhost:5173, backend on port 8000.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "live2d assistant": {
            "live2d-assistant": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

McpServers

{
    "live2d-assistant": {
        "command": "uv",
        "args": [
            "sync"
        ]
    }
}

# Live2D Assistant ## 项目简介 **Live2D Assistant** 是一个集成了 Live2D 虚拟形象和 AI 智能对话的多端（Web/Electron 桌面）助手平台。项目支持自定义 Live2D 模型、AI 大语言模型（LLM）接入，适合二次元互动、AI 助手、智能桌搭等多种场景。 ## 主要特性 - **Live2D 虚拟形象**：支持自定义模型、背景、缩放与位置调整。 - **AI 智能对话**：集成多种 LLM（如 Qwen、OpenAI、Gemini 等），支持上下文多轮对话。 - **多代理系统**：基于 agentic-agents 框架，支持 Router + 专家 Agent 协作。 - **多端支持**：Web 端（Vite+Vue3）、桌面端（Electron）一键切换。 - **丰富设置**：支持助手名称、系统提示词、模型参数、背景等多项自定义。 ## 目录结构 ``` ├── live2d-assistant-fe/ # 前端项目（Vue3 + Vite） │ ├── src/ │ │ ├── components/ # Vue 组件 │ │ ├── pages/ # 页面组件 │ │ ├── types/ # TypeScript 类型定义 │ │ └── utils/ # 工具函数 │ └── ... ├── live2d-assistant-server/ # 后端项目（Python FastAPI） │ ├── live2d_server/ │ │ ├── router.py # API 路由 │ │ └── agentic/ # Agent 模块 │ └── ... ├── electron-live2d/ # Electron 桌面端 ├── Makefile └── README.md ``` ## 安装与运行 ### 前端 ```bash cd live2d-assistant-fe npm install npm run dev # 开发服务器 (localhost:5173) npm run build # 生产构建 ``` ### 后端 ```bash cd live2d-assistant-server uv sync uv run fastapi run main.py --host 0.0.0.0 --port 8000 --static_path ../live2d-assistant-fe/dist ``` ### Electron 桌面端 ```bash cd electron-live2d npm install npm run start # 开发模式 npm run package # 打包 ``` ## Agent 系统项目采用 **agentic-agents** 多代理架构： ### 核心概念 - **Router Agent**：入口接待员，理解用户意图并分发任务 - **专家 Agent**：执行具体任务，如需协作可 transfer_to_Router ### Agent 配置 ```typescript interface AgentConfig { name: string; // Agent 名称 description: string; // Agent 描述 prompt?: string; // Agent 专属提示词 } ``` ### SSE 事件格式 - `{"resp_type": "text", "agent": "...", "content": "..."}` - 文本响应 - `{"resp_type": "tool_result", "agent": "...", "content": "..."}` - 工具执行结果 - `{"resp_type": "transfer", "from_agent": "...", "to_agent": "...", "reason": "..."}` - Agent 转移 - `{"resp_type": "status", "content": "..."}` - 状态提示 - `{"resp_type": "finished", "content": "..."}` - 结束 - `{"resp_type": "error", "content": "..."}` - 错误 ## License MIT

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Install

More like this

Context 7

Sequential Thinking

1Panel

🔎 GPT Researcher

Serena

FastMCP v2 🚀