TyranoStudio MCP Server

TyranoStudio（ティラノスタジオ）のプロジェクト管理とTyranoScriptのゲーム開発を支援する包括的なMCPサーバーです。

✨ 主要機能

🎮 プロジェクト管理 - 作成、削除、ファイル一覧
📝 シナリオ編集 - 読み書き、高度な構文検証
🎨 リソース管理 - 画像、音声ファイルの追加・一覧
🔍 高度な検証 - ラベル存在確認、リソース参照チェック
📊 プロジェクト分析 - 統計、プレイ時間推定、フロー可視化
🎭 テンプレート生成 - 5種類のシナリオテンプレート
🔧 Git連携 - バージョン管理サポート
⚡ 最適化ツール - 未使用リソース検出、一括操作

📁 対象ディレクトリ構造

/Users/shunsuke/TyranoStudio_mac_std_v603/
├── myprojects/          # ゲームプロジェクト格納ディレクトリ
│   └── [プロジェクト名]/
│       └── data/
│           ├── scenario/    # シナリオファイル(.ks)
│           ├── fgimage/     # 前景画像（キャラクター等）
│           ├── bgimage/     # 背景画像
│           ├── bgm/         # BGM
│           ├── sound/       # 効果音
│           ├── video/       # 動画
│           ├── image/       # その他画像
│           ├── system/      # システムファイル(Config.tjs等)
│           └── others/      # その他
├── system_master/       # テンプレート
│   ├── tyranoscript_ja/ # 日本語テンプレート
│   └── tyranoscript_en/ # 英語テンプレート
├── export/              # エクスポート先
└── dlc/                 # プラグイン

🛠️ 機能（ツール一覧）

1. プロジェクト管理

`list_projects`

説明: 作成済みプロジェクトの一覧を取得
パラメータ: なし
例:

{}

`create_project`

説明: 新しいプロジェクトを作成
パラメータ:
- project_name (必須): プロジェクト名
- template (オプション): テンプレート種類 (tyranoscript_ja または tyranoscript_en)
例:

{
  "project_name": "my_game",
  "template": "tyranoscript_ja"
}

`delete_project`

説明: プロジェクトを削除
パラメータ:
- project_name (必須): プロジェクト名
例:

{
  "project_name": "my_game"
}

`list_project_files`

説明: プロジェクト内のファイル・ディレクトリ一覧
パラメータ:
- project_name (必須): プロジェクト名
- path (オプション): 相対パス（省略時はルート）
例:

{
  "project_name": "my_game",
  "path": "data/scenario"
}

2. シナリオファイル操作

`read_scenario`

説明: シナリオファイル(.ks)を読み込む
パラメータ:
- project_name (必須): プロジェクト名
- scenario_file (必須): シナリオファイル名
例:

{
  "project_name": "my_game",
  "scenario_file": "scene1.ks"
}

`write_scenario`

説明: シナリオファイル(.ks)を書き込む
パラメータ:
- project_name (必須): プロジェクト名
- scenario_file (必須): シナリオファイル名
- content (必須): 書き込む内容
例:

{
  "project_name": "my_game",
  "scenario_file": "scene1.ks",
  "content": "[bg storage=\"room.jpg\"]\nこんにちは[p]"
}

`validate_scenario`

説明: シナリオファイルの構文チェック
パラメータ:
- project_name (必須): プロジェクト名
- scenario_file (必須): シナリオファイル名
例:

{
  "project_name": "my_game",
  "scenario_file": "scene1.ks"
}

3. 設定ファイル操作

`read_config`

説明: Config.tjsを読み込む
パラメータ:
- project_name (必須): プロジェクト名
例:

{
  "project_name": "my_game"
}

`write_config`

説明: Config.tjsを書き込む
パラメータ:
- project_name (必須): プロジェクト名
- content (必須): 書き込む内容
例:

{
  "project_name": "my_game",
  "content": "..."
}

4. リソース管理

`add_image`

説明: プロジェクトに画像を追加
パラメータ:
- project_name (必須): プロジェクト名
- source_path (必須): コピー元の画像パス
- dest_category (必須): 配置先カテゴリ（fgimage, bgimage, image, system等）
- dest_filename (オプション): 配置先ファイル名
例:

{
  "project_name": "my_game",
  "source_path": "/Users/shunsuke/Downloads/character.png",
  "dest_category": "fgimage",
  "dest_filename": "hero.png"
}

5. TyranoScriptリファレンス

`get_tyranoscript_reference`

説明: TyranoScriptのタグリファレンスを取得
パラメータ:
- category (オプション): カテゴリ（text, character, background, choice, variable, audio, all）
例:

{
  "category": "character"
}

📝 TyranoScriptの基本タグ

テキスト・メッセージ系

[l] - クリック待ち
[p] - クリック待ち＆改ページ
[r] - 改行
[cm] - メッセージクリア

キャラクター系

[chara_new name="キャラ名" storage="画像ファイル"] - キャラクター定義
[chara_show name="キャラ名"] - キャラクター表示
[chara_hide name="キャラ名"] - キャラクター非表示
[chara_mod name="キャラ名" storage="画像ファイル"] - 表情変更

背景・画像系

[bg storage="画像ファイル"] - 背景変更
[image layer="レイヤ番号" storage="画像ファイル"] - 画像表示

選択肢・ジャンプ系

[link target="ラベル名"]テキスト[endlink] - 選択肢
[glink target="ラベル名" text="選択肢テキスト"] - グラフィカル選択肢
[jump target="ラベル名"] - ジャンプ
[s] - 停止
*ラベル名 - ラベル定義

音声系

[playbgm storage="音楽ファイル"] - BGM再生
[playse storage="効果音ファイル"] - 効果音再生

🚀 セットアップ

1. 依存パッケージのインストール

pip install mcp

2. Claude Codeへの設定追加

~/.claude/mcp_config.json に以下を追加:

{
  "mcpServers": {
    "tyrano-studio": {
      "command": "python3",
      "args": ["/Users/shunsuke/tyrano_studio_mcp_server.py"],
      "description": "TyranoStudio project management"
    }
  }
}

3. サーバー起動確認

python3 /Users/shunsuke/tyrano_studio_mcp_server.py

💡 使用例

新しいゲームプロジェクトを作成

{
  "tool": "create_project",
  "arguments": {
    "project_name": "my_visual_novel",
    "template": "tyranoscript_ja"
  }
}

シンプルなシナリオを作成

{
  "tool": "write_scenario",
  "arguments": {
    "project_name": "my_visual_novel",
    "scenario_file": "scene1.ks",
    "content": "*start\n\n[bg storage=\"room.jpg\"]\n\nこんにちは、世界！[p]\n\nこれはTyranoScriptで作られたゲームです。[p]\n\n[s]"
  }
}

キャラクターを追加

{
  "tool": "add_image",
  "arguments": {
    "project_name": "my_visual_novel",
    "source_path": "/path/to/character.png",
    "dest_category": "fgimage"
  }
}

シナリオの構文チェック

{
  "tool": "validate_scenario",
  "arguments": {
    "project_name": "my_visual_novel",
    "scenario_file": "scene1.ks"
  }
}

📖 参考リンク

🎮 TyranoStudioの起動

open /Users/shunsuke/TyranoStudio_mac_std_v603/TyranoStudio.app

作成したプロジェクトは myprojects/ ディレクトリに保存され、TyranoStudioから直接開いてプレビュー・編集できます。

🧪 テスト

E2Eテストの実行

python3.11 test_e2e.py

テスト内容

✅ プロジェクト管理（作成、一覧、削除）
✅ シナリオファイル操作（読み書き、検証）
✅ テンプレート生成（5種類）
✅ 高度な検証（ラベル、リソース）
✅ 音声ファイル管理
✅ リソース参照検証

CI/CD

GitHub Actionsで自動テストを実行:

macOS環境でのE2Eテスト
プッシュ・PRごとに自動実行

🔧 トラブルシューティング

プロジェクトが見つからない

myprojects/ ディレクトリを確認
プロジェクト名のスペルミスを確認

画像が表示されない

画像ファイルが適切なディレクトリに配置されているか確認
ファイル名の大文字小文字を確認（特にmacOS）

シナリオの構文エラー

validate_scenario ツールで検証
タグの開始/終了が正しく対応しているか確認

📄 ライセンス

このMCPサーバーはTyranoStudioの操作を支援するものであり、TyranoScript/TyranoStudio本体のライセンスに従います。