🏈 足球数据 MCP 服务器

• MCP-Soccerdata 是一个开源的 Model Context Protocol (MCP) 服务器，连接到 SoccerDataAPI，提供最新的足球比赛信息并通过自然语言交互实现数据查询。

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

✨ 功能

🏟️ 实时足球比赛洞察

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

"现在有哪些足球比赛在进行？"
"告诉我巴黎圣日耳曼对阵阿斯顿维拉今天的预计首发阵容。"
"请告知我最近结束的比赛的比分和进球数。"

→ 提供结构化的相关信息，包括以下详细分类。

- 比赛列表与基本信息

• 全球正在举行的全部比赛清单
• 主场球队和客场球队名称
• 开赛时间和比赛日期
• 比赛场地信息
• 当前比分

- 比赛详情

• 比赛状态：已安排、进行中或已完成
• 进球分解：上半场、下半场、加时赛、点球大战
• 最终结果：胜、平局或败

- 关键比赛事件

• 进球情况（谁进的球、时间、方式）
• 替换情况
• 黄牌和红牌
• 点球判罚

- 队伍阵容

• 先发 XI 人名单
• 替补球员信息
• 伤病状态
• 阵型安排

- 赔率与投注信息

• 胜、平、负赔率
• 进球数上下限赔率
• 比分让球赔率

- 联赛元数据

• 联赛名称
• 国家
• 竞赛形式（如：常规赛季、淘汰赛阶段）

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

🎥 演示

🚀 快速开始

通过 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 Desktop）

手动安装指南

1. 克隆仓库：

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

2. 安装依赖项：

   pip install -r requirements.txt
   

3. 设置环境变量：
   创建一个 .env 文件并添加以下内容：

   API_KEY=your_api_key_here
   

4. 运行服务器：

   python server.py
   

配置 MCP 客户端

1. 打开客户端的配置界面。
2. 添加以下设置：
   • 名称：MCP-Soccerdata
   • 类型：football_data
   • 地址：http://localhost:5000

🛠️ 工具

获取实时比赛数据

print(get_livescores())

输出示例：

[
  {
    "home_team": "Paris Saint-Germain",
    "away_team": "Marseille",
    "score": "2-1",
    "status": "finished"
  },
  {
    "home_team": "Bayern Munich",
    "away_team": "Borussia Dortmund",
    "score": "3-0",
    "status": "in_progress"
  }
]

📜 许可证

本项目采用 MIT License。