MCP Novel Game Server

What is MCP Novel Game Server?

A multi-branch visual novel game server that supports English and Japanese scenario files written in YAML. It is designed as a learning resource to help users understand MCP (Model Context Protocol) Resources.

How to use MCP Novel Game Server?

Install dependencies with uv sync, then run the server by configuring a client (e.g., Claude Desktop, Cursor, Cline) with the command uv --directory <project_root> run src/server.py. Place scenario files in src/stories/<your_story>/ and select them via the server interface or scenario ID.

Key features of MCP Novel Game Server

• Supports multi-branch visual novel scenarios in English and Japanese.
• Scenario files are written in YAML format.
• Designed as an educational resource for MCP Resources.
• Works out-of-the-box on Cline.
• Easy to add new scenarios by creating directories and YAML files.
• Uses uv as the package manager and runner.

Use cases of MCP Novel Game Server

• Learning how to implement MCP Resources with a concrete, runnable example.
• Creating and testing branching narrative stories in a visual novel format.
• Extending the server with custom multi-language scenarios.
• Demonstrating MCP concepts in development environments like Cline, Claude Desktop, or Cursor.

FAQ from MCP Novel Game Server

What runtime/dependencies are required?

The server requires Python and the uv package manager. Run uv sync to install dependencies.

Can I write scenarios in languages other than English and Japanese?

The README explicitly supports English and Japanese scenario files. Other languages are not mentioned.

Where are scenario files located and how are they structured?

Scenario files go in src/stories/<your_story>/ as YAML files, with a meta.yaml describing the scenario.

Does the server work on all MCP client environments?

On Cline it works out-of-the-box. On Claude Desktop and Cursor you must use server_tool.py to launch and manage the server.

How do I add a new scenario?

Create a new directory under src/stories/, add YAML scenario files following existing examples, and include a meta.yaml.