live2d-to-agent

live2d-to-agent

Enables AI agents to control a Live2D desktop pet's expressions and actions via MCP protocol.

Category
Visit Server

README

Live2D to Agent

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

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

前置依赖

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

文件 来源 许可
live2dcubismcore.min.js Live2D Cubism SDK for Web Live2D 专有软件许可 — 使用前请阅读并遵守其条款
pixi.min.js npm install pixi.js@6.5.10，从 dist/browser/ 提取 MIT
cubism4.min.js npm install pixi-live2d-display@0.4.0，从 dist/ 提取 MIT

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 工具

工具 参数 说明
model_load path 加载模型（.model3.json 所在目录）
expression_list — 列出所有可用表情
expression_set name 切换表情
action_list — 列出可用语义动作
action_perform name, intensity?, count? 执行语义动作
settings_get — 读取桌面设置
settings_set 键值对 修改窗口/模型设置

语义动作

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 及其模型文件分别受各自许可条款约束。

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured