抛硬币 MCP 服务器

一个使用 random.org 随机性 API 提供真随机抛硬币功能的 MCP 服务器。该服务器通过提供可配置方向的随机结果生成工具来演示模型上下文协议 (MCP)。

特征

工具

• flip_coin - 抛一枚可配置面数的硬币

  • 可选sides参数（默认值：2）

  • 使用来自 random.org 的真正随机性

  • 对边缘情况（0、1 或负数）的特殊处理

  • 对于 2 面：返回“正面”或“反面”

  • 对于三面：返回“正面”、“反面”或“_”

  • 对于 n>3 面：返回“它落在 X 面上”

Related MCP server: Meme MCP Server

发展

安装依赖项：

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 Inspector ：

npx @modelcontextprotocol/inspector node build/index.js

贡献

欢迎贡献代码！欢迎提交 Pull 请求。

执照

麻省理工学院