Live2D to Agent

个人闲暇娱乐作品 — Live2D 桌面宠物，支持主流 Agent 通过 MCP 协议控制。 当前处于早期阶段。

将 Live2D 角色作为桌面宠物运行，AI Agent（Claude Desktop 等）可通过 MCP 协议控制其表情和动作。

前置依赖

运行前需自行获取以下文件，放入 packages/desktop/dist/vendor/：

Live2D Cubism Core 是 Live2D Inc. 的专有软件，本项目不包含、不分发该文件。

快速开始

# 安装依赖
cd packages/desktop
npm install

# 放置 SDK 文件（见上表）
mkdir -p dist/vendor
# 将三个文件放入 dist/vendor/

# 配置模型路径
node ../../dist/cli.js init

# 启动桌面宠物
npx electron .

LLM 可控制的 MCP 工具

语义动作

nod · shake_head · tilt_head · wink · slow_blink · double_blink

可调整设置

window.width · window.height · window.x · window.y · window.opacity model.scale · model.offsetX · model.offsetY

配置 Claude Desktop

在 claude_desktop_config.json 中添加：

{
  "mcpServers": {
    "live2d": {
      "command": "npx",
      "args": ["tsx", "/path/to/live2d-to-agent/packages/adapters/mcp/src/index.ts"]
    }
  }
}

模型要求

• Cubism 3 或 4 格式 .model3.json

• 支持 .exp3.json 表情文件

• 使用前请确保模型授权允许个人使用

许可

本项目代码采用 MIT 协议。Live2D Cubism SDK 及其模型文件分别受各自许可条款约束。