soccer-mcp-server

soccer-mcp-server

3

The Soccer MCP Server is a Python-based application that utilizes the Model Context Protocol to provide comprehensive football data, leveraging API-Football for live and historical statistics. It supports features like league standings, player stats, and live match events, facilitating seamless integration with applications seeking football information.

Soccer MCP Server

A Python server implementing Model Context Protocol (MCP) for football statistics and live match data using the API-Football service.

Features

  • League data (standings, fixtures, schedules)
  • Team information and fixtures
  • Player statistics and profiles
  • Live match data (events, statistics, timelines)
  • Match analysis (statistics, events)

Usage

The server is implemented using the Fast MCP framework and can be run as a standalone service.

Usage with Claude Desktop
  • Docker and direct Python execution methods available for setup. Ensure API keys are configured properly.

Configuration

  • Requires an API key from RapidAPI for the API-Football service.
  • The server runs with a 30-second timeout and supports graceful shutdown.

Technical Details

  • Built on API-Football via RapidAPI
  • MCP for API interface
  • Pydantic for input validation
  • Requests for API communication