Coin Flip MCP Server

Coin Flip MCP サーバー

random.org のランダム性 API を使って真のランダムなコイントスを提供する MCP サーバーです。このサーバーは、設定可能な面の数でランダムな結果を生成するツールを提供し、Model Context Protocol を実演します。

特長

ツール

• flip_coin - 設定可能な面の数でコインを投げます
  • sides パラメーターは省略可能です（デフォルト：2）
  • random.org の真のランダム性を使用します
  • 特殊なケース（0、1、負の面の数）を適切に処理します
  • 面が2つの場合：「表」または「裏」を返します
  • 面が3つの場合：「表」、「裏」、または「_」を返します
  • 面が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 クライアントに接続すると、自然言語でコイントスツールを操作できます。たとえば：

• 「コインを投げて」
• 「6面のサイコロを振って」
• 「1から20までのランダムな数を教えて」

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

デバッグ

MCP サーバーは stdio 経由で通信するため、デバッグが難しい場合があります。MCP Inspector の使用をおすすめします：

npx @modelcontextprotocol/inspector node build/index.js

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

MIT