COC MCP Server

🚀 COC MCP Server

This is an implementation of a Call of Cthulhu (COC) role - playing tool server based on the MCP (Model Context Protocol). The server offers a series of dice tools for COC role - playing.

🚀 Quick Start

To use this COC MCP Server, follow these steps:

1. Download the code.
2. Create a virtual environment (recommended).
3. Install the dependencies.
4. Configure the content of server_config.example.json in your MCP client (e.g., Cursor). Note: The command should point to the absolute path of Python in your virtual environment; the args should point to the absolute path of src/server/main.py.

✨ Features

• An MCP server implemented based on FastMCP.
• Multiple dice tools are provided (d4, d6, d8, d10, d100).
• It uses the standard input - output (stdio) transmission mode.
• A simple MCP client is included for testing.

📦 Installation

1. Create and activate a virtual environment:

python -m venv venv
source venv/bin/activate  # Linux/Mac
# or
.\venv\Scripts\activate   # Windows

2. Install the dependencies:

pip install -r requirements.txt

📚 Documentation

Directory Structure

.
├── README.md
├── requirements.txt
├── servers_config.json
├── src/
│   ├── server/         # MCP server implementation
│   ├── tools/          # Dice tool implementation
│   └── client/         # Test client
└── tests/              # Test files

Development Notes

• The business logic is separated from the MCP server code.
• The server functionality is implemented using the FastMCP framework.
• It adheres to the MCP protocol specification.

This project is written using Cursor + Claude 3.7 sonnet.

🔧 Technical Details

• Environment Requirements:
  • Python 3.8+
  • Virtual environment (venv)

📄 License

This project is under the MIT license.