随机硬币翻转服务

一个基于Model Context Protocol的服务器,提供使用random.org的真实随机硬币翻转功能,可配置面数。

  • by TeglonLabs
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 TeglonLabs/coin-flip-mcp

使用说明

硬币翻转MCP服务器

一个MCP服务器,使用random.org的随机性API提供真正的随机抛硬币。该服务器通过提供一个工具来生成具有可配置侧的随机结果,从而演示了模型上下文协议。

特性

工具

  • flip_coin -翻转硬币,可配置硬币的两面数
    • 可选的 sides 参数(默认值:2)
    • 使用random.org中的真正随机性
    • 边缘情况(0、1或负侧)的特殊处理
    • 两面:返回“头部”或“尾部”
    • 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

贡献

欢迎投稿!请随时提交拉取请求。

许可证

麻省理工学院