COC MCP Server

🚀 COC MCP 服務器

這是一個基於 MCP（模型上下文協議）的克蘇魯的呼喚（Call of Cthulhu, COC）跑團工具服務器。它提供了一系列骰子工具，能極大地助力克蘇魯的呼喚跑團活動。

🚀 快速開始

本服務器為克蘇魯的呼喚跑團提供了骰子工具。你可以按照以下步驟使用：

1. 下載代碼
2. 創建虛擬環境（推薦）
3. 安裝依賴
4. 將 server_config.example.json 中的內容配置到你的 MCP 客戶端中（如 Cursor） 注意：command 指向你的虛擬環境的 python 絕對路徑；args 指向 src/server/main.py 的絕對路徑。

✨ 主要特性

• 基於 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

📚 詳細文檔

目錄結構

.
├── README.md
├── requirements.txt
├── servers_config.json
├── src/
│   ├── server/         # MCP 服務器實現
│   ├── tools/          # 骰子工具實現
│   └── client/         # 測試客戶端
└── tests/              # 測試文件

開發說明

• 業務邏輯與 MCP 服務器代碼分離
• 使用 FastMCP 框架實現服務器功能
• 遵循 MCP 協議規範

本項目使用 Cursor+Claude 3.7 sonnet 編寫

📄 許可證

本項目採用 MIT 許可證。