⚽️ Soccerdata MCP Server

⚽️ Soccerdata MCP Server

2025.04.16 6

Python足球数据实时比赛信息娱乐功能

MCP-Soccerdata 是一个开源的 Model Context Protocol (MCP) 服务器，通过自然语言交互连接到 SoccerDataAPI 提供最新的足球比赛信息。它专为与 MCP 兼容的客户端（如 Claude Desktop）设计，利用大型语言模型 (LLMs) 检索足球数据。

View on GitHub

Overview

✨ 核心功能

🏟️ 实时足球比赛洞察

提供全球正在进行的足球比赛的实时信息。
包括比赛列表、基本信息、比赛详情、关键比赛事件、球队阵容、赔率和投注信息、联赛元数据等。

🚀 快速开始

前置依赖

Python 3.12+
uv 包管理器
Soccerdata API 账户
MCP 兼容客户端（如 Claude for Desktop）

安装步骤

克隆仓库

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

安装依赖

uv sync

设置环境变量创建 .env 文件并添加你的 API 密钥

AUTH_KEY=your_auth_key

调试方式

配置 MCP 客户端编辑 ~/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"
          ]
      }
  }
}

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。