football-api-mcp

MCP-сервер (Model Context Protocol) для 5DollarFootballAPI — предоставляет Claude, Cursor и любому MCP-совместимому ИИ-ассистенту живые данные о футболе: расписание матчей, live-счета, турнирные таблицы, статистику, букмекерские коэффициенты и полную историю движения коэффициентов, включая линии по угловым и карточкам.

Спросите своего ассистента, например:

• «Какие матчи Премьер-лиги сегодня и какие текущие счета?»

• «Покажи таблицу по угловым для лиги 39 в этом сезоне.»

• «Как менялись коэффициенты 1x2 для матча 1234567 до начала игры?»

Настройка

Вам нужен API-ключ от 5dollarfootballapi.com — бесплатный тариф (без карты) покрывает расписание матчей, live-счета и турнирные таблицы; инструменты коэффициентов требуют платного плана (от $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 и идентификатором запроса, чтобы ассистент мог объяснить, что пошло не так.

Разработка

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