⚽️ Soccerdata MCP 服务器

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

• 它专为与支持 MCP 的客户端（例如 Claude Desktop）一起使用而设计，允许用户利用大型语言模型 (LLM) 检索足球数据。

✨ 特点

🏟️ 现场足球比赛洞察

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

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

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

- 比赛列表和基本信息

• 所有当前活跃比赛的全局列表

• 主队和客队名称

• 开球时间和比赛日期

• 体育场详情

• 当前分数

- 比赛详情

• 比赛状态：已安排、进行中或已结束

• 进球分布：上半场、下半场、加时赛、点球大战

• 最终结果：胜、平、负

- 关键比赛赛事

• 进球事件（谁进球、何时进球、如何进球）

• 替换

• 黄牌和红牌

• 处罚

- 球队阵容

• 首发阵容

• 替补球员

• 受伤状况

• 团队组建

- 赔率和投注信息

• 赢/平/输赔率

• 高于/低于赔率

• 让分投注赔率

- 联赛元数据

• 联赛名称

• 国家

• 比赛形式（例如常规赛、淘汰赛）

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

Related MCP server: HackathonWatch MCP Server

🎥 演示

🚀 快速入门

通过 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 文件。

• 使用模型上下文协议构建