MCP Novel Game Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Novel Game Server list my available scenarios"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Novel Game Server

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.pyto launch and manage the server properly.
How to Use
1. Install dependencies
uv sync2. Run the server
{
"novel-game-server": {
"command": "uv",
"args": [
"--directory",
"/Users/username/Documents/projects/mcp-novel-game-server", ## Replace with your project root
"run",
"src/server.py"
]
}
}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_roseorvillainess_rose_ja)Add scenario YAML files (see existing examples)
Add a
meta.yamldescribing the scenario
5. File structure
project-root/
├── src/
│ ├── server.py
│ └── stories/
│ ├── villainess_rose/
│ ├── villainess_rose_ja/
│ └── ...
├── mcp_example.json
├── pyproject.toml
└── README.mdNotes
Use
uvas the package manager and runner.Scenarios can be written in English or Japanese.
See
src/stories/README.mdfor scenario tree and details.
Related MCP server: OpenWebGAL Assistant
日本語
概要
このリポジトリは、分岐型ノベルゲーム(ビジュアルノベル)サーバーです。英語・日本語両対応。
MCP(Model Context Protocol)のリソースを理解するためのリソースとして設計されています。
YAML形式でシナリオを追加・編集できます。
注意: Cline環境ではそのまま動作しますが、それ以外の環境(例えばClaude DesktopやCursor)では
server_tool.pyを使ってサーバーの起動・管理を行ってください。
使い方
1. 依存パッケージのインストール
uv sync2. サーバーの起動
{
"novel-game-server": {
"command": "uv",
"args": [
"--directory",
"/Users/username/Documents/projects/mcp-novel-game-server", ## ご自身のプロジェクトルートに変更してください
"run",
"src/server.py"
]
}
}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を参照してください。
Available Tools
3 toolschooseC
Record player's choice within their selected story.
Inputs: player_id (required), current_scene_id (required), choice_id (required), free_text.
load_scene_imageC
Return the image for the player's current story and scene. Resize and compress until data size <= 1MB.
Inputs: player_id (required), scene_id (required), max_width, max_height.
select_storyC
Bind a story to the player and return its opening scene.
Inputs: player_id (required), story_id (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a distinct purpose: selecting a story, recording a choice, and loading a scene image. No overlap in functionality.
All tool names use lowercase with underscores, but the structure varies: 'choose' is a single verb while others follow verb_noun pattern. The inconsistency is minor.
With 3 tools, the server is well-scoped for a simple novel game interface. Each tool serves a clear purpose without unnecessary bloat.
The basic interaction flow is covered, but missing tools like fetching story list, scene text, or saving progress leave notable gaps that agents may need to work around.
Maintenance
Related MCP Connectors
MCP server for understanding Javascript internals from ECMAScript specification.
MCP server for developers documentation, generated by doc2mcp.
MCP server for AI dialogue using various LLM models via AceDataCloud
MCP server for developer documentation, generated by doc2mcp.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server designed for learning and experimentation. It provides a foundational setup for developers to build, run, and debug MCP server implementations using Node.js.-
- FlicenseNot gradedqualityDmaintenanceMCP server that automates WebGAL game development tasks such as resource management, script editing, documentation lookup, and AI-powered voice generation using LLMs.33 npm1-
- FlicenseAqualityDmaintenanceAn MCP server that provides a visual novel world engine, enabling AI clients to drive interactive galgame experiences with narrative consistency.31-
- AlicenseCqualityAmaintenanceAn MCP server for Ren'Py project tooling that enables AI agents to inspect game state, evaluate expressions, read/write variables, and capture screenshots from running Ren'Py games.54359 PyPI12MIT