COC MCP Server

🚀 COC MCP サーバー

このサーバーは、MCP（モデルコンテキストプロトコル）に基づく、克蘇魯の呼び声（Call of Cthulhu, COC）のTRPGツールサーバーの実装です。様々なダイスツールを提供し、克蘇魯の呼び声のTRPGに利用できます。

🚀 クイックスタート

このサーバーは、MCPに基づいた克蘇魯の呼び声のTRPGツールで、様々なダイスツールを提供します。以下の手順でサーバーを使い始めることができます。

✨ 主な機能

• FastMCPをベースにしたMCPサーバー
• 複数のダイスツール（d4, d6, d8, d10, d100）を提供
• 標準入出力（stdio）を用いたデータ転送モード
• テスト用のシンプルなMCPクライアントを含む

📦 インストール

環境要件

• Python 3.8以上
• 仮想環境（venv）

インストール手順

1. 仮想環境の作成とアクティブ化：

python -m venv venv
source venv/bin/activate  # Linux/Mac
# または
.\venv\Scripts\activate   # Windows

2. 依存関係のインストール：

pip install -r requirements.txt

💻 使用例

基本的な使用法

1. コードをダウンロードします。
2. 仮想環境を作成することをおすすめします。
3. 依存関係をインストールします。
4. server_config.example.json の内容をあなたのMCPクライアント（例：Cursor）に設定します。 注意：command は仮想環境のPythonの絶対パスを指定し、args は src/server/main.py の絶対パスを指定してください。

🔧 技術詳細

• 業務ロジックとMCPサーバーコードは分離されています。
• FastMCPフレームワークを使用してサーバー機能を実装しています。
• MCPプロトコルの仕様に準拠しています。

本プロジェクトはCursor+Claude 3.7 sonnetを使用して作成されています。

📄 ライセンス

MITライセンスの下で公開されています。

📚 ディレクトリ構成

.
├── README.md
├── requirements.txt
├── servers_config.json
├── src/
│   ├── server/         # MCPサーバーの実装
│   ├── tools/          # ダイスツールの実装
│   └── client/         # テスト用クライアント
└── tests/              # テストファイル