football-api-mcp

5DollarFootballAPI용 MCP(Model Context Protocol) 서버 — Claude, Cursor 및 MCP를 지원하는 모든 AI 어시스턴트에게 실시간 축구(사커) 데이터를 제공합니다: 일정, 실시간 스코어, 순위, 통계, 베팅 배당률 및 전체 배당률 변동 내역(코너 및 카드 라인 포함).

어시스턴트에게 다음과 같은 질문을 해보세요:

• "오늘 프리미어리그 경기는 무엇이 있고, 현재 스코어는 어떻게 되나요?"

• "이번 시즌 리그 39의 코너 순위를 보여주세요."

• "경기 1234567의 1x2 배당률이 킥오프 전에 어떻게 변했나요?"

설정

5dollarfootballapi.com에서 API 키가 필요합니다 — 무료 티어(카드 불필요)는 일정, 실시간 스코어 및 순위를 포함하며, 배당률 도구는 유료 플랜(월 $5부터)이 필요합니다.

Claude Code

claude mcp add football-api -e FIVEDOLLARFOOTBALL_API_KEY=fb_live_your_key -- npx -y football-api-mcp

Claude Desktop

claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "football-api": {
      "command": "npx",
      "args": ["-y", "football-api-mcp"],
      "env": { "FIVEDOLLARFOOTBALL_API_KEY": "fb_live_your_key" }
    }
  }
}

Cursor

.cursor/mcp.json(프로젝트) 또는 ~/.cursor/mcp.json(전역)에 추가:

{
  "mcpServers": {
    "football-api": {
      "command": "npx",
      "args": ["-y", "football-api-mcp"],
      "env": { "FIVEDOLLARFOOTBALL_API_KEY": "fb_live_your_key" }
    }
  }
}

도구

모든 도구는 읽기 전용입니다. 오류는 API의 오류 코드와 요청 ID와 함께 도구 오류로 반환되므로, 어시스턴트가 무엇이 잘못되었는지 설명할 수 있습니다.

개발

npm install
npm test          # in-memory MCP client/server tests, no network
FIVEDOLLARFOOTBALL_API_KEY=... npm start   # run over stdio

기본 HTTP 클라이언트는 공식 fivedollarfootball 패키지입니다. 엔드포인트 참조: 5dollarfootballapi.com/docs.

라이선스

MIT