⚽️ Soccerdata MCP Server

⚽️ Soccerdata MCP 服务

• MCP-Soccerdata 是一款开源的 Model Context Protocol (MCP) 服务，可连接 SoccerDataAPI，通过自然语言交互提供最新的足球比赛信息。

• 专为 Claude Desktop 等支持 MCP 的客户端设计，用户可以借助大模型（LLM）获取足球数据。

---

✨ 功能

🏟️ 实时足球比赛信息

MCP-Soccerdata 专注于提供全球正在进行的足球比赛的实时信息。

“现在正在进行哪些足球比赛？” “今天 PSG 对阵 Aston Villa 的预计首发阵容是什么？” “请告诉我近期足球比赛的比分和进球数。”

→ 以结构化格式提供相关足球数据，包括下文所述的详细类别。

- 比赛列表与基本信息

• 当前所有比赛的全球列表
• 主队和客队名称
• 开球时间和比赛日期
• 体育场详情
• 当前比分

- 比赛详情

• 比赛状态：已安排、进行中或已结束
• 进球明细：上半场、下半场、加时赛、点球大战
• 最终结果：胜、平或负

- 关键比赛事件

• 进球事件（进球者、时间和方式）
• 换人
• 黄牌和红牌
• 点球

- 球队阵容

• 首发 11 人
• 替补球员
• 伤病情况
• 球队阵型

- 赔率与投注信息

• 胜 / 平 / 负赔率
• 大 / 小球赔率
• 让球赔率

- 联赛元数据

• 联赛名称
• 国家
• 赛事形式（例如常规赛、淘汰赛阶段）

⚠️ 仅关注正在进行、即将开始和近期结束的比赛

---

🎥 演示

---

🚀 快速开始

通过 Smithery 安装

通过 Smithery 为 Claude Desktop 自动安装 Amadeus MCP Server：

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

前置条件

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

1. 克隆并设置

• 克隆仓库

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

• 安装依赖

uv sync

2. 获取 API 密钥并设置环境

• 创建包含凭据的 .env 文件：

AUTH_KEY=your_auth_key

在 https://soccerdataapi.com/ 注册并获取你自己的身份验证密钥。

3. 配置 MCP 客户端

• 在 MCP 客户端（例如 Claude for Desktop）中注册此服务。

编辑 ~/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"
          ]
      }
  }
}

---

🛠️ 工具

向 MCP 客户端提供以下工具：

get_livescores()

-> 返回全球正在进行的足球比赛的实时信息。

---

📝 许可证

• 本项目采用 MIT License 许可。详情请参阅 LICENSE 文件。
• 基于 Model Context Protocol 构建