Exia Voiceroid

🚀 Exia情景生成器MCP服务器

Exia情景生成器MCP服务器是专为Exia 这款小说游戏引擎打造的情景文件生成服务器。它能够以「琴叶姐妹解说」的独特形式生成情景，并在Exia中进行展示，为用户带来别样的体验。

🚀 快速开始

Exia情景生成器MCP服务器的使用能让你轻松在Exia中展示独特情景。你可以按照以下步骤，快速开启使用之旅。

✨ 主要特性

• 情景生成：根据指定的主题，生成「琴叶姐妹解说」形式的情景。
• 格式转换：将生成的情景转换为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可能会产生费用。