关键词

随机数抛硬币工具random.org实用工具

Coin Flip MCP Server 使用说明

项目简介

Coin Flip MCP Server 是一个基于 Model Context Protocol (MCP) 的工具服务器，它提供了一个 'flip_coin' 工具，允许用户通过自然语言指令进行抛硬币操作。该服务器使用 random.org 的真随机数 API 来确保结果的随机性。

主要功能点

  • 'flip_coin' 工具: 模拟抛硬币，可以配置硬币的侧面数量（默认为3）。
    • 支持自定义侧面数量，默认为3面。
    • 使用 random.org API 获取真随机数。
    • 针对特殊情况（0, 1, 负数侧面）进行处理。
    • 对于2面硬币，返回 "heads" 或 "tails"。
    • 对于3面硬币，默认返回 "-", "0", 或 "+", 也支持自定义侧面名称。
    • 对于超过3面的硬币，返回 "side X"，其中 X 是随机数结果。

安装步骤

  1. 确保你的电脑上已安装 Node.js 和 npm。
  2. 克隆 GitHub 仓库到本地： 
    git clone https://github.com/TeglonLabs/coin-flip-mcp.git
  3. 进入仓库目录： 
    cd coin-flip-mcp
  4. 安装项目依赖： 
    npm install
  5. 构建服务器： 
    npm run build

服务器配置

要将此 MCP 服务器与 MCP 客户端（如 Claude Desktop）连接，需要配置客户端以指定服务器的启动命令。以下是 Claude Desktop 的配置示例，你需要将配置添加到 'claude_desktop_config.json' 文件中。

  • MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
  • Windows: '%APPDATA%/Claude/claude_desktop_config.json'

将以下 JSON 配置添加到 'claude_desktop_config.json' 文件的 'mcpServers' 字段中：

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

配置参数说明：

  • 'server name': 'coin-flip' - 服务器名称，可以自定义，用于在客户端中标识该服务器。
  • 'command': 'npx' - 用于执行 npm 包的命令。
  • 'args': '["-y", "@modelcontextprotocol/server-coin-flip"]' - 传递给 'npx' 的参数。
    • '-y': 可能用于自动确认 npm 包的安装（如果需要）。
    • '@modelcontextprotocol/server-coin-flip': предполагается, что это имя npm пакета, который будет запущен. 注意：此配置假定 '@modelcontextprotocol/server-coin-flip' 包已发布到 npm 仓库。如果未发布，你可能需要修改 'command' 和 'args' 以指向本地构建的 'build/index.js' 文件。

本地运行 (如果未发布 npm 包)

如果 '@modelcontextprotocol/server-coin-flip' 包未发布到 npm，或者你想直接运行本地构建的版本，请使用以下配置，并根据你的实际路径修改 'args' 中的路径：

{
  "mcpServers": {
    "coin-flip-local": {
      "command": "node",
      "args": ["path/to/your/coin-flip-mcp/build/index.js"]  // 将 "path/to/your/coin-flip-mcp" 替换为你的本地仓库路径
    }
  }
}
  • 'server name': 'coin-flip-local' - 本地运行的服务器名称，可以自定义。
  • 'command': 'node' - 用于执行 Node.js 脚本的命令。
  • 'args': '["path/to/your/coin-flip-mcp/build/index.js"]' - 指向本地构建的服务器入口文件 'build/index.js' 的路径。请务必将 'path/to/your/coin-flip-mcp' 替换为你的实际仓库路径。

基本使用方法

配置并启动 MCP 客户端后，即可使用自然语言指令与 'flip_coin' 工具互动。例如，在 Claude Desktop 中：

  • "Flip a coin" (默认3面硬币)
  • "Roll a 2-sided coin" (2面硬币，结果为 heads 或 tails)
  • "Flip a coin with 6 sides" (6面硬币，结果为 side 1 到 side 6)
  • "Use side names past, present, future to flip a 3-sided coin" (3面硬币，结果为 past, present, future)

信息

分类

网页与API

访问项目