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\nTyranoScript作[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公式
• TyranoBuilderGUI開発

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 検証
• 開始/終了正対応確認

MCPTyranoStudio操作支援TyranoScript/TyranoStudio本体従