mcpField
C
Coin Flip MCP Server

Coin Flip MCP Server

本地服务
github.com/TeglonLabs游戏娱乐093 周前更新
代码仓库

关于 Coin Flip MCP Server

Coin Flip MCP Server 为需要随机抛币或多面随机结果的用户提供 MCP 服务。它使用 random.org 的随机源，并按面数处理结果。

主要功能

  1. 01使用 random.org 生成随机结果
  2. 02可配置面数
  3. 03两面时返回正面或反面
  4. 04多面时返回对应面数结果

适用场景

  1. 01通过抛币做随机选择
  2. 02生成多面随机结果

MCP 相关

它向 MCP 客户端提供 `flip_coin` 工具，并支持可选的 `sides` 参数。

#coin-flip#randomness#mcp-server

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "coin-flip": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/inspector"
      ]
    }
  }
}
启动命令npx -y @modelcontextprotocol/inspector

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@modelcontextprotocol/inspector

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Coin Flip MCP 服务

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

功能

工具
  • flip_coin - 抛一枚面数可配置的硬币
    • 可选的 sides 参数（默认值：2）
    • 使用来自 random.org 的真正随机性
    • 针对边界情况（0、1 或负面数）进行特殊处理
    • 面数为 2：返回“Heads”或“Tails”
    • 面数为 3：返回“Heads”、“Tails”或“_”
    • 面数大于 3：返回“It landed on side 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

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。