MCP Novel Game Server

@gotalab

About MCP Novel Game Server

No overview available yet

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "novel-game-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/username/Documents/projects/mcp-novel-game-server",
        "run",
        "src/server.py"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.

Frequently asked questions

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`.

Comments

Basic information

More Media & Design MCP servers

SVGator

Drive your SVGator account from any AI assistant. Prompt an animation, get an editable project back, and export it as SVG, Lottie, GIF, MP4, and more, then open it in the editor to finish by hand.