exia-scenario-generator MCP Server

exia というノベルゲームエンジン向けのシナリオファイルを作成する MCP サーバです。
「琴葉姉妹解説」形式のシナリオを生成し、exia で表示します。

機能

• 指定されたお題について「琴葉姉妹解説」形式のシナリオを生成
• 生成したシナリオを exia 用の JSON 形式に変換
• exia を GitHub からダウンロードしてセットアップ
• 生成したシナリオを 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", //（clone した 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