MCP Novel Game Server
Description
# MCP Novel Game Server  [ビジュアルノベルゲームのMCPサーバーの作り方](https://note.com/gotalab/n/n34b4fcc46d22) ## English ### Overview This repository is a novel game server that supports multi-branch scenario stories (visual novels) in both English and…
About
# MCP Novel Game Server  [ビジュアルノベルゲームのMCPサーバーの作り方](https://note.com/gotalab/n/n34b4fcc46d22) ## 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…
Details
- Author
- gotalab
- GitHub stars
- 6
- Downloads
- 301
- Categories
- Media
Jump to
- 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.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
MCP Novel Game ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp novel game server": {
"novel-game-server": {
"command": "uv",
"args": [
"--directory",
"/Users/username/Documents/projects/mcp-novel-game-server",
"run",
"src/server.py"
]
}
}
}
}McpServers
{
"novel-game-server": {
"command": "uv",
"args": [
"--directory",
"/Users/username/Documents/projects/mcp-novel-game-server",
"run",
"src/server.py"
]
}
}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.py to launch and manage the server properly.
How to Use
1. Install dependencies
uv sync
2. 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 insrc/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 undersrc/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
- Useuv 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. サーバーの起動
{
"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 を参照してください。Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
