抛硬币 MCP 服务器

一个使用 random.org 的随机数 API 提供真正随机抛硬币的 MCP 服务器。此服务器通过提供一个用于生成具有可配置面的随机结果的工具来演示模型上下文协议 (Model Context Protocol)。

功能

工具

• 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 客户端后，您可以使用自然语言与抛硬币工具进行交互。例如：

• "抛个硬币"
• "掷一个 6 面骰子"
• "给我一个 1 到 20 之间的随机数"

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

调试

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

npx @modelcontextprotocol/inspector node build/index.js

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

MIT