exia-scenario-generator MCP Server

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

機能

指定されたお題について「琴葉姉妹解説」形式のシナリオを生成
生成したシナリオを exia 用の JSON 形式に変換
exia を GitHub からダウンロードしてセットアップ
生成したシナリオを exia で表示

必要条件

Node.js v20.x 以上
OpenAI API キー
Git

セットアップ

リポジトリをクローンまたはダウンロード

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

必要なパッケージをインストール

npm install

TypeScript のコンパイル (変更を加えたら実行してください)

npm run build

Claude Desktop での利用方法

Claude Desktop を起動
設定画面を開き、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

Claude Desktop で以下のように使用
- 「exia で量子コンピュータについて解説して」と入力
- MCP サーバが起動し、シナリオを生成して exia を起動
- exia アプリケーション（Electron）が別ウィンドウで起動し、シナリオをプレイ

利用可能なツール

generateScenario: お題からシナリオを生成
setupExia: exia をダウンロードしてセットアップ
saveScenario: 生成したシナリオを保存
exiaVoiceroidExplain: シナリオ生成から exia 起動までを一括実行（推奨）

注意事項

初回実行時は exia のダウンロードとセットアップに時間がかかります
キャラクター画像は自前で用意して手動で差し替える必要があります
- exia のドキュメントはこちら
OpenAI API の利用には料金がかかる場合があります

ライセンス

MIT

Claude Desktop での利用方法

Claude Desktop を起動

設定画面を開き、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

Claude Desktop で以下のように使用

「exia で量子コンピュータについて解説して」と入力
MCP サーバが起動し、シナリオを生成して exia を起動
exia アプリケーション（Electron）が別ウィンドウで起動し、シナリオをプレイ