TyranoStudio MCP Server

Test Status Python License

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

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Enables comprehensive management of TyranoStudio visual novel projects including project creation, scenario editing with syntax validation, resource management, and TyranoScript development assistance. Supports project analysis, template generation, and Git integration for visual novel game development.