Coin Flip MCP Server

基本能力

产品定位

Coin Flip MCP Server 是一个提供真实随机硬币翻转服务的工具，主要用于生成随机结果。

核心功能

• 提供 flip_coin 工具，可配置硬币的面数
• 可选 sides 参数（默认：2）
• 使用 random.org 的真实随机性
• 处理边缘情况（0、1 或负数的面数）
• 对于 2 面：返回 "Heads" 或 "Tails"
• 对于 3 面：返回 "Heads"、"Tails" 或 "_"
• 对于 n>3 面：返回 "It landed on side X"

适用场景

• 需要随机结果的游戏或决策
• 需要模拟硬币翻转或骰子滚动的场景
• 需要生成随机数的应用

工具列表

• flip_coin：翻转硬币或生成随机结果，支持可配置的面数

常见问题解答

• 调试困难：由于 MCP 服务器通过 stdio 通信，调试可能具有挑战性。推荐使用 MCP Inspector 进行调试。

使用教程

使用依赖

安装依赖：

npm install

安装教程

1. 构建服务器：

npm run build

1. 开发时使用自动重建：

npm run watch

1. 在 Claude Desktop 中添加服务器配置：
2. MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
3. Windows: %APPDATA%/Claude/claude_desktop_config.json

添加以下配置：

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

调试方式

使用 MCP Inspector 进行调试：

npx @modelcontextprotocol/inspector node build/index.js

许可证

该项目遵循 MIT 开源许可条款。