Coin Flip MCP

🚀 一枚硬币のMCPサーバー

random.orgのランダム性APIを使用して、真のランダムなコイントスを提供するMCPサーバーです。このサーバーは、設定可能な面数を持つツールを提供することで、モデルコンテキストプロトコルを実演します。

✨ 主な機能

ツール

• flip_coin - 設定可能な面数のコインを投げる
  • オプションの sides パラメータ（デフォルト値：2）
  • random.orgの真のランダム性を使用
  • 特殊なケース（0、1、または負の面数）を特別に処理
  • 2面の場合：「表」または「裏」を返す
  • 3面の場合：「表」、「裏」または「_」を返す
  • n > 3面の場合：「X面に落ちました」を返す

📦 インストール

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"]
    }
  }
}

📚 ドキュメント

開発

依存関係をインストールする：

npm install

サーバーをビルドする：

npm run build

自動再構築を伴う開発：

npm run watch

サンプルの使い方

Claude DesktopのようなMCPクライアントに接続したら、自然言語でコイントスツールと対話できます。例えば：

• 「コインを投げて」
• 「六面サイコロを振って」
• 「1から20までの乱数を生成して」

サーバーはrandom.orgの真のランダム性を使って結果を生成します。

デバッグ

MCPサーバーはstdioを介して通信するため、デバッグは難しい場合があります。MCPモニターの使用をおすすめします。

npx @modelcontextprotocol/inspector node build/index.js

貢献

貢献を歓迎します！プルリクエストを自由に提出してください。

📄 ライセンス

MIT