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"
  }
}

📖 参考リンク

• TyranoScript公式サイト
• タグリファレンス
• TyranoBuilder（GUI開発ツール）

🎮 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本体のライセンスに従います。