Football Live MCP

HTTP를 통해 API-Football의 실시간 축구 데이터를 제공하는 원격 MCP 서버로, MCP SDK 없이 JSON-RPC 2.0을 직접 구현합니다.

로컬 Football Intelligence MCP 서버의 동반자입니다. 이 서버는 현재 시즌을 제공하고, 로컬 서버는 PostgreSQL에 저장된 과거 데이터베이스(2010-2025)를 제공합니다.

프로토콜

전송: HTTP. 단일 엔드포인트, 요청당 JSON-RPC 메시지 하나.

구현된 메서드: initialize, notifications/initialized, ping, tools/list, tools/call.

프로토콜 버전: 2025-06-18.

도구

리그 ID: 39 프리미어리그, 140 라리가, 135 세리에 A, 78 분데스리가, 61 리그 1, 94 프리메이라리가, 2 UEFA 챔피언스리그.

로컬 실행

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_KEY에 API-Football 키를 추가합니다.

5. 배포합니다. 공개 엔드포인트는 https://<service>.onrender.com/mcp가 됩니다.

무료 플랜은 비활성 상태 후 서비스를 절전 모드로 전환하므로, 일시 중지 후 첫 요청은 약 50초가 걸립니다. 라이브 데모 전에 GET /을 한 번 호출하여 깨워 두세요.

MCP 호스트에서 사용

호스트 구성에 url 필드가 있는 항목을 추가합니다:

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