MCP Novel Game Server

🚀 MCP 小説ゲームサーバー

このサーバーは分岐型ノベルゲーム（ビジュアルノベル）をサポートし、英語と日本語の両方のバージョンを同時に実行できます。また、MCP（モデルコンテキストプロトコル）のリソースを理解するのに役立ちます。

Visual Novel ゲームの MCP サーバーの作り方

🚀 クイックスタート

✨ 主な機能

• 多分岐の物語をサポートするゲームサーバーで、英語と日本語の両方のバージョンを同時に実行可能。
• YAML 形式で書かれた物語ファイルをサポートし、独自の物語を追加することで拡張可能。
• 簡単にサーバーを実行、編集、新しい物語を追加することができる。

📦 インストール

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>/ に配置します。
• サーバーのインターフェイスまたはクライアントでシナリオ 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

📚 ドキュメント

⚠️ 重要提示

Cline 環境ではそのまま使用できますが、他の環境（Claude Desktop や Cursor など）では server_tool.py を使用してサーバーを正しく起動および管理してください。

💡 使用建议

• uv をパッケージマネージャーおよび実行ツールとして使用してください。
• シナリオは英語または日本語で記述できます。
• シナリオツリーと詳細情報については、src/stories/README.md を参照してください。