Football Live MCP

API-FootballのライブサッカーデータをHTTP経由で公開するリモートMCPサーバーです。MCP SDKを使わずにJSON-RPC 2.0を直接実装しています。

ローカルのFootball Intelligence MCPサーバーのコンパニオンです。こちらは現在のシーズンを提供し、ローカル版はPostgreSQLに保存された過去のデータベース（2010-2025）を提供します。

プロトコル

トランスポート: HTTP。単一のエンドポイントで、リクエストごとに1つのJSON-RPCメッセージを処理します。

実装メソッド: initialize、notifications/initialized、ping、tools/list、tools/call。

プロトコルバージョン: 2025-06-18。

ツール

リーグID: 39 Premier League、140 La Liga、135 Serie A、78 Bundesliga、61 Ligue 1、94 Primeira Liga、2 UEFA Champions League。

ローカルでの実行

pip install -r requirements.txt
export API_FOOTBALL_KEY=your_key_here
python server.py                    # listens on :8080

確認:

curl http://localhost:8080/

curl -X POST http://localhost:8080/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Renderへのデプロイ

1. このディレクトリをGitHubリポジトリにプッシュします。

2. RenderでNew Web Serviceを作成し、そのリポジトリを接続します。

3. Renderはrender.yamlを読み取ります。ランタイムがPythonであることと無料プランを確認してください。

4. API-Footballキーを指定して環境変数API_FOOTBALL_KEYを追加します。

5. デプロイします。公開エンドポイントはhttps://<service>.onrender.com/mcpになります。

無料プランでは非アクティブ状態が続くとサービスがスリープするため、一時停止後の最初のリクエストには約50秒かかります。ライブデモの前にGET /に一度アクセスして、スリープを解除してください。

MCPホストからの使用

MCPホスト設定にurlフィールドを含むエントリを追加します:

{
  "mcpServers": {
    "football_live": { "url": "https://<service>.onrender.com/mcp" }
  }
}