exia-scenario-generator MCP Server

exia 是一个面向小说游戏引擎的场景文件生成的 MCP 服务器。它生成“琴叶姐妹解说”形式的场景，并在 exia 中显示。

<img width="800" alt="" src="https://github.com/user-attachments/assets/f02cc41a-6456-44d3-bb22-190cb899515d" />

功能

• 根据给定的主题生成“琴叶姐妹解说”形式的场景
• 将生成的场景转换为 exia 所需的 JSON 格式
• 从 GitHub 下载并设置 exia
• 在 exia 中显示生成的场景

必要条件

• Node.js v20.x 或更高版本
• OpenAI API 密钥
• Git

设置

1. 克隆或下载仓库

git clone https://github.com/kokushin/exia-mcp.git
cd exia-mcp

2. 安装所需包

npm install

3. 编译 TypeScript（如有更改，请运行）

npm run build

在 Claude Desktop 上的使用方法

1. 启动 Claude Desktop

2. 打开设置界面，添加 MCP 服务器

{
  "mcpServers": {
    "exia-scenario-generator": {
      "command": "npx",
      "args": [
        "-y",
        "/path/to/exia-mcp", //（替换为您克隆的 exia-mcp 的路径）
        "--openai-api-key=YOUR_API_KEY", //（替换为您的 OpenAI API 密钥）
        "--stdio"
      ]
    }
  }
}

• 注意：YOUR_API_KEY 需要替换为实际的 OpenAI API 密钥
• 注意：如果无法执行 npx，请使用绝对路径指定 例如: /path/to/.volta/bin/npx

3. 在 Claude Desktop 上使用
   • 输入：“用 exia 解说量子计算机”
   • MCP 服务器启动，生成场景并启动 exia
   • exia 应用程序（Electron）将在新窗口中启动并播放场景

可用工具

• generateScenario: 根据主题生成场景
• setupExia: 下载并设置 exia
• saveScenario: 保存生成的场景
• exiaVoiceroidExplain: 从场景生成到 exia 启动的一键操作（推荐）

注意事项

• 首次运行时，下载和设置 exia 可能需要一些时间
• 角色图片需要自行准备并手动替换
  • 更改 exia 图片和样式的方法见此处
• 使用 OpenAI API 可能会产生费用

许可证

MIT