Exia Voiceroid

🚀 Exia情景生成器MCPサーバー

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の使用には費用が発生する場合があります。