コインフリップMCPサーバー

random.orgの乱数APIを用いて、真にランダムなコイン投げを提供するMCPサーバーです。このサーバーは、設定可能なサイドを持つランダムな結果を生成するツールを提供することで、モデルコンテキストプロトコル（MCP）のデモンストレーションを行います。

特徴

ツール

• flip_coin - 設定可能な面数でコインを投げる

  • オプションのsidesパラメータ（デフォルト: 2）

  • random.org の真のランダム性を使用

  • エッジケース（0、1、または負の側）の特別な処理

  • 2面の場合：「表」または「裏」を返します

  • 3面の場合：「表」、「裏」、または「_」を返します

  • n>3 面の場合: 「X 面に着地しました」を返します。

Related MCP server: MCP Lottery Demo

発達

依存関係をインストールします:

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

貢献

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

ライセンス

マサチューセッツ工科大学