Live2D Assistant
About
Live2d Assistant is an extensive assistant application with mcp server and multi-agent support.
Details
- License
- MIT
Explore
- 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 AssistantCommand (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
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 虚拟形象和 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
安装与运行
前端
cd live2d-assistant-fe
npm install
npm run dev # 开发服务器 (localhost:5173)
npm run build # 生产构建
后端
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 桌面端
cd electron-live2d
npm install
npm run start # 开发模式
npm run package # 打包
Agent 系统
项目采用 agentic-agents 多代理架构：
核心概念
- Router Agent：入口接待员，理解用户意图并分发任务 - 专家 Agent：执行具体任务，如需协作可 transfer_to_RouterAgent 配置
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
MITSign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
