Live2d Assistant is an extensive assistant application with mcp server and multi-agent support.
6 stars
Vue
Updated Sep 8, 2025
Documentation
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）一键切换。
- 丰富设置：支持助手名称、系统提示词、模型参数、背景等多项自定义。
目录结构
code
├── 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/distElectron 桌面端
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
Similar MCP
Based on tags & features
Trending MCP
Most active this week