Coin Flip MCP

🚀 一枚硬幣的 MCP 服務器

這是一個藉助 random.org 的隨機性 API 來提供真實隨機硬幣翻轉功能的 MCP 服務器。它通過提供可配置邊數的工具，生動地演示了模型上下文協議，為用戶帶來更靈活、真實的隨機體驗。

✨ 主要特性

工具

• flip_coin：可實現具有可配置邊數的硬幣翻轉。
  • 具備可選的 sides 參數，默認值為 2。
  • 採用 random.org 的真實隨機性，確保結果的真實性。
  • 對邊緣情況（如 0、1 或負數邊數）進行了特殊處理，增強了程序的健壯性。
  • 對於 2 邊的情況，會返回 "正面" 或 "反面"。
  • 對於 3 邊的情況，會返回 "正面"、"反面" 或 "_"。
  • 對於邊數 n>3 的情況，會返回 "它落在第 X 邊"。

📦 安裝指南

開發環境依賴安裝

npm install

服務器構建

npm run build

帶自動重建的開發模式

npm run watch

與 Claude Desktop 配合使用的安裝步驟

要與 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

🤝 貢獻

歡迎大家積極貢獻！如果您有任何改進或優化的想法，請隨時提交拉取請求。

📄 許可證

本項目採用 MIT 許可證。