MCP-足球数据

⚽️ Soccerdata MCP 服务器

MCP-Soccerdata是一个开源模型上下文协议 (MCP)服务器，它连接到SoccerDataAPI 以通过自然语言交互提供最新的足球比赛信息。
它专为与支持 MCP 的客户端（例如 Claude Desktop）一起使用而设计，允许用户利用大型语言模型 (LLM) 检索足球数据。

✨ 特点

🏟️ 现场足球比赛洞察

MCP-Soccerdata 专注于提供有关世界各地正在进行的足球比赛的实时信息。

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

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

- 比赛列表和基本信息

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

- 比赛详情

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

- 关键比赛赛事

进球事件（谁进球、何时进球、如何进球）
替换
黄牌和红牌
处罚

- 球队阵容

首发阵容
替补球员
受伤状况
团队组建

- 赔率和投注信息

赢/平/输赔率
高于/低于赔率
让分投注赔率

- 联赛元数据

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

⚠️ 专注于现场、即将进行和最近结束的比赛

🎥 演示

🚀 快速入门

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Amadeus MCP 服务器：

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

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