Overview
what is COC MCP Server?
COC MCP Server is a server implementation for the Cthulhu tabletop role-playing game, based on the Model Context Protocol (MCP). It provides a set of dice tools for gameplay.
how to use COC MCP Server?
To use COC MCP Server, download the code, create a virtual environment, install dependencies, and configure the MCP client with the server settings.
key features of COC MCP Server?
- MCP server implementation based on FastMCP
- Provides various dice tools (d4, d6, d8, d10, d100)
- Uses stdio transmission mode
- Includes a simple MCP client for testing
use cases of COC MCP Server?
- Facilitating gameplay for Cthulhu tabletop RPG sessions.
- Rolling dice for various game mechanics.
- Testing MCP client-server interactions.
FAQ from COC MCP Server?
- What is the minimum Python version required?
Python 3.8 or higher is required.
- Is there a client included?
Yes, a simple MCP client is included for testing purposes.
- How do I configure the server?
You need to configure the server settings in the server_config.example.json file.
Content
COC MCP Server
这是一个基于MCP(Model Context Protocol)的COC跑团工具服务器实现。该服务器提供了一组骰子工具，可用于COC跑团。
功能特性
- 基于FastMCP实现的MCP服务器
- 提供多种骰子工具(d4, d6, d8, d10, d100)
- 使用stdio传输模式
- 包含简单的MCP客户端用于测试
目录结构
.
├── README.md
├── requirements.txt
├── servers_config.json
├── src/
│ ├── server/ # MCP服务器实现
│ ├── tools/ # 骰子工具实现
│ └── client/ # 测试客户端
└── tests/ # 测试文件
环境要求
- Python 3.8+
- 虚拟环境(venv)
安装说明
- 创建并激活虚拟环境：
python -m venv venv
source venv/bin/activate # Linux/Mac
# 或
.\venv\Scripts\activate # Windows
- 安装依赖：
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
No tools information available.
