Obinopaul Soccer MCP Server

🚀 Soccer MCP Server

A football data analysis server implementing the Model Context Protocol (MCP) using the API-Football service. This server can provide comprehensive football data and supports integration with Claude Desktop.

🚀 Quick Start

This Soccer MCP Server is built on API-Football, offering users a wealth of football-related data and features through the MCP protocol. Users can integrate this server into Claude Desktop via configuration to access real-time or historical football match data, team information, and other relevant statistics.

✨ Features

Core Features

• Real-time Data: Obtain real-time data of ongoing football matches.
• Historical Data: Query results and detailed statistical data of past matches.
• Team Information: Get basic information, line - ups, and historical performance of specific teams.
• League Standings: View the latest standings of various football leagues.
• Match Calendar: Get the schedule of upcoming football matches.

Advanced Features

• Data Analysis: Conduct statistics and analysis on match data and generate visual reports.
• Score Prediction: Provide a simple score prediction model based on historical data.
• News Updates: Get the latest news related to specific teams or leagues.

📦 Installation

Install Dependencies

pip install -r requirements.txt

Run the Server

python soccer_server.py

Configuration Examples

Run with Docker

1. Clone the repository:

   git clone https://github.com/obinopaul/soccer-mcp-server.git
   cd soccer-mcp-server
   

2. Install dependencies:

   pip install -r requirements.txt
   

3. Build the Docker image:

   docker build -t soccer_server .
   

4. Run the container and configure environment variables:

   docker run -d -p 5000:5000 -e RAPID_API_KEY_FOOTBALL=your_api_key_here --name soccer_server soccer_server
   

Run the Python Script Directly

1. Configure environment variables:

   export RAPID_API_KEY_FOOTBALL=your_api_key_here
   

2. Add configuration to claude_desktop_config.json:

   {
     "mcpServers": {
       "soccer_server": {
         "command": "/path/to/your/python",
         "args": [
           "/path/to/soccer_server.py"
         ],
         "env": {
           "RAPID_API_KEY_FOOTBALL": "your_api_key_here"
         }
       }
     }
   }
   

🔧 Technical Details

Technologies Used

• API-Football: Provides football data through RapidAPI.
• MCP Protocol: Implements a unified API interface.
• Pydantic: Used for input validation and data modeling.
• Requests: Handles HTTP requests.

📄 License

This MCP server is open - sourced under the MIT License.