# exia-scenario-generator MCP Server

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

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

## 機能

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

## 必要条件

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

## セットアップ

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

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

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

```bash
npm install
```

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

```bash
npm run build
```

## Claude Desktop での利用方法

1. Claude Desktop を起動

2. 設定画面を開き、MCP サーバを追加

```json
{
  "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 のドキュメントは[こちら](https://github.com/kokushin/exia?tab=readme-ov-file#%E7%94%BB%E5%83%8F%E3%82%84%E3%82%B7%E3%83%8A%E3%83%AA%E3%82%AA%E3%82%92%E5%A4%89%E6%9B%B4%E3%81%97%E3%81%9F%E3%81%84%E5%A0%B4%E5%90%88)
- OpenAI API の利用には料金がかかる場合があります

## ライセンス

MIT