mcp-odds-api

mcp-odds-api

OddsAPI と連携するための、シンプルな Model Context Protocol MCP サーバーです。

特長

• 環境変数を使用して、クエリの対象を特定の地域と単一のスポーツに限定します。

SSE と STDIO の両方のトランスポートに対応しています。

ツール

このサーバーは、OddsAPI と連携するために以下のツールを実装しています。

• get_events:

  • 試合中および今後開催予定のイベント（試合）を取得します。

• get_odds:

  • 選択した賭け市場について、今後開催予定のすべてのイベント（試合）のオッズを取得します。

• get_event_odds:

  • 選択した賭け市場について、特定のイベント（試合）のオッズを取得します。

設定

1. 次の場所にある Claude Desktop の設定ファイルを作成するか、編集します。

   • macOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

2. 以下を追加します。

{
  "mcpServers": {
    "mcp-bauplan": {
      "command": "/path/to/uvx",
      "args": ["mcp-odds-api"],
      "env": {
        "ODDS_API_KEY": "<your-api-odds-key>",
        "ODDS_API_REGIONS": "<region1>", "<region2>",
        "ODDS_API_SPORT": "<selected-sport-key>",
      }
    }
  }
}

3. /path/to/uvx を uvx 実行ファイルの絶対パスに置き換えます。ターミナルで which uvx コマンドを実行してパスを確認してください。これにより、サーバーの起動時に正しいバージョンの uvx が使用されます。

4. Claude Desktop を再起動して、変更を適用します。

スタンドアロンの SSE サーバーを実行する

.env.example から .env ファイルを作成し、次のコマンドを実行します。

$ uvx --env-file /path/to/.env mcp-odds-api --transport sse --port 9090

uvx ではなく nvx を使用すると、デフォルトのレジストリ https://pypi.org から mcp-bauplan が取得されることに注意してください。

開発

セットアップ

1. 前提条件：

   • Python 3.10 以降。
   • OddsAPI キー（こちらから申請）。
   • uv パッケージマネージャー（インストール）。

2. リポジトリのクローン：

git clone https://github.com/marcoeg/mcp-odds-api
cd mcp-nvd

3. 環境変数の設定：
   • プロジェクトのルートに .env ファイルを作成します。

   ODDS_API_KEY="" ODDS_API_REGIONS="", "" ODDS_API_SPORT=""

4. 依存関係のインストール：

uv sync
uv pip install -e .

SSE トランスポートでサーバーを起動する

$ uv run mcp-odds-api --transport sse --port 9090
python-dotenv could not parse statement starting at line 2
2025-04-30 19:35:34 - dotenv.main - WARNING - python-dotenv could not parse statement starting at line 2
INFO:     Started server process [68314]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
INFO:     Uvicorn running on http://0.0.0.0:9090 (Press CTRL+C to quit)

インスペクターを実行する

$ CLIENT_PORT=8077 TARGET_PORT=9090 \
npx @modelcontextprotocol/inspector run

Starting MCP inspector...
⚙️ Proxy server listening on port 6277
🔍 MCP Inspector is up and running at http://127.0.0.1:8077 🚀

その後、ブラウザーで MCP Inspector に表示された URL を開きます。トランスポートの種類として SSE を選択してください。