⚽️ 足球数据 MCP 服务器

• MCP-Soccerdata 是一个开源的 模型上下文协议（MCP） 服务器，它连接到 SoccerDataAPI，通过自然语言交互提供最新的足球比赛信息。

• 设计用于与支持 MCP 的客户端（如 Claude Desktop）一起使用，允许用户通过大型语言模型（LLMs）检索足球数据。

---

✨ 特性

🏟️ 实时足球比赛洞察

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

“现在有哪些足球比赛正在进行？”
“今天巴黎圣日耳曼对阵阿斯顿维拉的比赛预测阵容是什么？”
“请告诉我最近几场足球比赛的比分和进球数。”

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

- 比赛列表及基本信息

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

- 比赛详情

• 比赛状态：计划中、进行中或结束
• 进球分解：上半场、下半场、加时赛、点球大战
• 最终结果：胜、平、负

- 关键比赛事件

• 进球事件（谁进球了，何时，如何）
• 替换
• 黄牌和红牌
• 点球

- 队伍阵容

• 首发十一人
• 候补球员
• 受伤情况
• 阵型

- 赔率及投注信息

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

- 联赛元数据

• 联赛名称
• 国家
• 竞赛形式（例如，常规赛、淘汰赛）

⚠️ 仅专注于实时、即将开始和最近结束的比赛

---

🎥 演示

---

🚀 快速开始

通过 Smithery 安装

要通过 Smithery 自动安装 Amadeus MCP 服务器以供 Claude Desktop 使用：

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

预备条件

• Python 3.12+
• uv 包管理器
• Soccerdata API 账户
• 支持 MCP 的客户端（例如，桌面版 Claude）

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/ 注册并获取自己的 Auth 密钥。

3. 配置 MCP 客户端

• 在您的 MCP 客户端（例如，桌面版 Claude）中注册此服务器。

编辑 ~/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 文件。
• 使用 模型上下文协议 构建