home / mcp / tyranostudio mcp server

TyranoStudio MCP Server

MCP Server for TyranoStudio - Project management and TyranoScript development tools

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "shunsukehayashi-tyrano-studio-mcp": {
      "command": "python3",
      "args": [
        "/Users/shunsuke/tyrano_studio_mcp_server.py"
      ]
    }
  }
}

You set up TyranoStudio MCP Server to manage TyranoStudio projects, edit scenarios, handle resources, and validate content from a centralized MCP interface. This server streamlines project creation, scenario writing, resource management, and automated checks, enabling you to work efficiently with TyranoScript-based games.

How to use

You interact with the MCP through a client that communicates with the TyranoStudio MCP Server. Use the available tools to create and manage projects, read and write scenario files, modify configuration files, add images and other resources, and validate your TyranoScript content. You can also generate templates, inspect project statistics, and integrate with Git for version control.

How to install

Prerequisites you need before starting: Python 3.x and the pip package manager.

pip install mcp

Configure the MCP client integration for Claude Code with the following JSON snippet. This enables TyranoStudio project management as an MCP server entry named tyrano-studio.

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

Verify the MCP server is ready by starting the server process shown here. This confirms the integration is active and ready to accept commands from your MCP client.

python3 /Users/shunsuke/tyrano_studio_mcp_server.py

Additional setup notes

If you prefer to run TyranoStudio MCP Server directly for testing, ensure the server you start corresponds to the path you configured above and that Python3 is available in your environment.

Configuration and usage notes

The MCP server expects you to use specific tooling commands to manage projects and files. You will typically issue actions such as create_project, delete_project, list_projects, read_scenario, write_scenario, and validate_scenario to interact with TyranoStudio data assets. Each action is described in the tool reference section so you know exactly what parameters to provide.

Troubleshooting

If the MCP client cannot reach the TyranoStudio server, verify that the Python process is running and that the configured path to tyrano_studio_mcp_server.py exists. Check that your environment has Python 3.x and that network access between the client and server is permitted if you are using a hosted or remote setup.

Notes

The TyranoStudio MCP Server is designed to be used with TyranoScript-based projects. It provides project management, scenario editing, resource handling, and validation, enabling smooth workflow automation within a single MCP ecosystem.

Examples of common tasks

Create a new project named my_visual_novel using the Japanese TyranoScript template, then write a simple scene and validate it. You can adapt these patterns to your own project names and content.

Available tools

list_projects

Retrieve a list of all created projects.

create_project

Create a new project with a given name and optional template.

delete_project

Delete an existing project by name.

list_project_files

List files and directories inside a project at a given relative path.

read_scenario

Read the content of a TyranoScript scenario file (.ks) within a project.

write_scenario

Write content to a TyranoScript scenario file (.ks) inside a project.

validate_scenario

Check the syntax and structure of a TyranoScript scenario file.

read_config

Read the Config.tjs file for a given project.

write_config

Write content to the Config.tjs file for a given project.

add_image

Add an image resource to a project in a specified category.

get_tyranoscript_reference

Fetch TyranoScript tag references by category for reference.