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 许可证。