COC MCP Server logo

COC MCP Server

by longbowzz

This is a COC role-playing tool server implementation based on MCP (Model Context Protocol). The server provides a set of dice tools for COC role-playing.

View on GitHub

Last updated: N/A

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)

安装说明

  1. 创建并激活虚拟环境:
python -m venv venv
source venv/bin/activate  # Linux/Mac
# 或
.\venv\Scripts\activate   # Windows
  1. 安装依赖:
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