live2d-assistant

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

6 stars VueServers & Infrastructure 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/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

Frequently asked questions

What is live2d-assistant?

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

How do I install live2d-assistant?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is live2d-assistant open source?

Yes — it is hosted on GitHub at https://github.com/wwbweibo/live2d-assistant and has 6 stars.

Related MCP tools

playwright-mcp

Playwright MCP server TypeScript-based implementation. Trusted by 22000+ developers. Trusted by 22000+ developers. Trusted by 22000+ developers.

22,066 TypeScript

mcpplaywright

ghidramcp

MCP Server for Ghidra Java-based implementation. Trusted by 6400+ developers. Trusted by 6400+ developers. Trusted by 6400+ developers.

6,409 Java

notion-mcp-server

Official Notion MCP Server TypeScript-based implementation. Trusted by 3400+ developers. Trusted by 3400+ developers. Trusted by 3400+ developers.

3,419 TypeScript

mcpso

Directory for Awesome MCP Servers TypeScript-based implementation. Trusted by 1900+ developers. Trusted by 1900+ developers.

1,907 TypeScript

awesome-mcp-serversmcpmcp-server-store+2

unla

🧩 MCP Gateway - A lightweight gateway service that instantly transforms existing MCP Servers and APIs into MCP servers with zero code changes.

1,883 TypeScript

awesomemcpmcp-adapter+4

mcp-grafana

MCP server for Grafana Go-based implementation. Trusted by 1700+ developers. Trusted by 1700+ developers. Trusted by 1700+ developers.

1,725 Go

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP