一枚硬币的 MCP 服务器

一个使用 random.org 的随机性 API 提供真实随机硬币翻转的 MCP 服务器。该服务器通过提供具有可配置边数的工具来演示模型上下文协议。

功能

工具

• flip_coin - 翻转一枚硬币，具有可配置的边数
  • 可选的 sides 参数（默认值：2）
  • 使用 random.org 的真实随机性
  • 特殊处理边缘情况（0、1 或负数边数）
  • 对于 2 边：返回 "正面" 或 "反面"
  • 对于 3 边：返回 "正面"、"反面" 或 "_"
  • 对于 n>3 边：返回 "它落在第 X 边"

开发

安装依赖：

npm install

构建服务器：

npm run build

带有自动重建的开发：

npm run watch

安装

要与 Claude Desktop 一起使用，请添加服务器配置：

在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json%

{
  "mcpServers": {
    "coin-flip": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-coin-flip"]
    }
  }
}

示例用法

一旦连接到像 Claude Desktop 这样的 MCP 客户端，您可以使用自然语言与硬币翻转工具交互。例如：

• "翻转一枚硬币"
• "掷一个六面骰子"
• "给我一个 1 到 20 的随机数"

服务器将使用 random.org 的真实随机性来生成结果。

调试

由于 MCP 服务器通过 stdio 通信，调试可能具有挑战性。我们建议使用 MCP 监视器：

npx @modelcontextprotocol/inspector node build/index.js

贡献

欢迎贡献！请随时提交拉取请求。

许可证

MIT