Tyrano Studio MCP

🚀 TyranoStudio MCP Server

TyranoStudio（ティラノスタジオ）のプロジェクト管理とTyranoScriptのゲーム開発を支援する包括的なMCPサーバーです。このサーバーは、ゲーム開発における様々な作業を効率化し、開発者がスムーズにゲームを制作できるようサポートします。

✨ 主な機能

• 🎮 プロジェクト管理：作成、削除、ファイル一覧を簡単に操作できます。
• 📝 シナリオ編集：読み書きが可能で、高度な構文検証機能も備えています。
• 🎨 リソース管理：画像、音声ファイルの追加と一覧表示ができます。
• 🔍 高度な検証：ラベル存在確認やリソース参照チェックを行います。
• 📊 プロジェクト分析：統計、プレイ時間推定、フロー可視化を提供します。
• 🎭 テンプレート生成：5種類のシナリオテンプレートを利用できます。
• 🔧 Git連携：バージョン管理サポートがあり、開発の効率化に役立ちます。
• ⚡ 最適化ツール：未使用リソース検出や一括操作が可能です。

📦 インストール

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

📁 対象ディレクトリ構造

/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="効果音ファイル"] - 効果音再生

💻 使用例

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

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