MCP服务器掷骰子 (mcp-server-diceroll)

这是一个简单的 MCP (模型调用协议) 服务器的演示项目。该服务器提供掷骰子功能和基本的数值运算功能。

功能

• 数值加法
• 可定制的掷骰子（可以指定骰子的面数和投掷次数）
• 动态的问候消息生成

要求

• Python 3.12 或更高版本
• mcp 库 1.6.0 或更高版本
• uv (Python 包管理器)

安装

1. 克隆仓库：

git clone https://github.com/yourusername/mcp-server-diceroll.git
cd mcp-server-diceroll

2. 如果没有安装 uv，请安装它：

curl -sSf https://astral.sh/uv/install.sh | bash

3. 使用 uv 创建虚拟环境并安装依赖项：

uv venv
source .venv/bin/activate  # macOS/Linux 平台
# 或者
.venv\Scripts\activate  # Windows 平台

uv pip install -e .

使用方法

要启动服务器，请执行：

python server.py

或者，也可以使用 uv 运行：

uv run python server.py

服务器启动后，以下工具将可用：

1. add - 将两个数值相加
2. roll_dice - 掷骰子（默认为 6 面骰子，投掷 1 次）
3. greeting://{name} - 生成针对指定名称的问候消息

参考资料

• 从骰子开始的Model Context Protocol (MCP): 连接生成AI和外部工具的协议
• Anthropic MCP 官方发布
• modelcontextprotocol/python-sdk

示例

有关如何向服务器发送请求的信息，请参阅 MCP 客户端的文档。