What is Mcp Novel Game Server

The mcp-novel-game-server is a novel game server designed to support multi-branch scenario stories (visual novels) in both English and Japanese. It serves as a resource for understanding MCP (Model Context Protocol) Resources.

Use cases

Use cases for the mcp-novel-game-server include developing visual novels, creating interactive educational content, and building narrative-driven games where players can make choices that affect the story outcome.

How to use

To use the mcp-novel-game-server, first install dependencies using ‘uv sync’. Then, run the server by executing the command with the appropriate directory path. You can play or test scenarios by placing your scenario files in the designated folder and selecting them via the server’s interface. New scenarios can be added by creating a new directory and adding YAML files along with a meta.yaml file.

Key features

Key features of the mcp-novel-game-server include support for YAML scenario files, the ability to run and edit scenarios easily, and compatibility with both English and Japanese languages. The server also allows for easy extension with custom stories.

Where to use

The mcp-novel-game-server can be used in various fields such as game development, interactive storytelling, educational tools, and any application that requires branching narrative structures.

MCP Novel Game Server

ビジュアルノベルゲームのMCPサーバーの作り方

English

Overview

This repository is a novel game server that supports multi-branch scenario stories (visual novels) in both English and Japanese.

This repository is designed as a resource to help you better understand MCP (Model Context Protocol) Resources.

You can run, edit, and add new scenarios easily. The server supports scenario files written in YAML and can be extended with your own stories.

Note: On Cline, everything works out-of-the-box. On other environments like Claude Desktop and Cursor, please use server_tool.py to launch and manage the server properly.

How to Use

1. Install dependencies

uv sync

2. Run the server

3. Play or test a scenario

• Place your scenario files in src/stories/<your_story>/
• You can select scenarios via the server’s interface or by specifying scenario IDs in your client.

4. Add a new scenario

• Create a new directory under src/stories/ (e.g. villainess_rose or villainess_rose_ja)
• Add scenario YAML files (see existing examples)
• Add a meta.yaml describing the scenario

5. File structure

project-root/
├── src/
│   ├── server.py
│   └── stories/
│       ├── villainess_rose/
│       ├── villainess_rose_ja/
│       └── ...
├── mcp_example.json
├── pyproject.toml
└── README.md

Notes

• Use uv as the package manager and runner.
• Scenarios can be written in English or Japanese.
• See src/stories/README.md for scenario tree and details.

日本語

概要

このリポジトリは、分岐型ノベルゲーム（ビジュアルノベル）サーバーです。英語・日本語両対応。

MCP（Model Context Protocol）のリソースを理解するためのリソースとして設計されています。

YAML形式でシナリオを追加・編集できます。

注意: Cline環境ではそのまま動作しますが、それ以外の環境（例えばClaude DesktopやCursor）では server_tool.py を使ってサーバーの起動・管理を行ってください。

使い方

1. 依存パッケージのインストール

uv sync

2. サーバーの起動

3. シナリオのプレイ・テスト

• src/stories/<your_story>/ にシナリオファイルを配置
• サーバーのUIまたはクライアントからシナリオIDを指定して選択可能

4. 新しいシナリオの追加

• src/stories/ 配下に新しいディレクトリを作成（例: villainess_rose や villainess_rose_ja）
• YAMLファイルでシナリオを作成
• シナリオ説明用の meta.yaml も追加

5. ファイル構成例

project-root/
├── src/
│   ├── server.py
│   └── stories/
│       ├── villainess_rose/
│       ├── villainess_rose_ja/
│       └── ...
├── mcp_example.json
├── pyproject.toml
└── README.md

注意

• パッケージ管理・実行は uv を利用してください。
• シナリオは英語・日本語どちらでも作成可能です。
• シナリオの詳細やツリーは src/stories/README.md を参照してください。