使用说明

⚽️ Soccerdata MCP服务器

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

✨ 特性

🏟️ 现场足球比赛见解

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

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

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

-匹配列表和基本信息

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

-匹配详细信息

比赛状态：已安排、正在进行或已完成
进球细分：上半场、下半场、加时赛、点球大战
最终结果：赢、平或输

-关键比赛事件

目标事件（谁得分、何时得分、如何得分）
替换
黄牌和红牌
处罚

-团队阵容

开始XI
候补人员
受伤情况
团队组建

-赔率和投注信息

赢/赢/输赔率
赔率过高/过低
盘口投注赔率

-联盟元数据

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

⚠️ 专注于生活, 即将到来的，以及 最近完成 火柴

🎥 演示

🚀 快速开始

通过Smithery安装

通过以下方式自动安装Amadeus MCP Server for 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 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文件。
内置于模型上下文协议