SoccerDataAPI

Quick Start# Installing via Smithery

To install Amadeus MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @yeonupark/mcp-soccer-data --client claude

Prerequisites

• Python 3.12+
• uv package manager
• Soccerdata API account
• MCP-compatible client (e.g., Claude for Desktop)

1. Clone and Setup

• Clone the repository

git clone https://github.com/yeonupark/mcp-soccer-data.git
cd mcp-soccer-data

• Install dependencies

uv sync

2. Get Your API Key and Set Environment

• Create a .env file with your credentials:

AUTH_KEY=your_auth_key

Sign up on https://soccerdataapi.com/ and get your own Auth keys.

3. Configure MCP Client

• Register this server in your MCP client (e.g., Claude for Desktop). Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-soccer-data": {
      "command": "/ABSOLUTE/PATH/TO/PARENT/FOLDER/uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/src/",
        "run",
        "--env-file",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/.env",
        "server.py"
      ]
    }
  }
}