JinDaGe - mcp-soccer-data MCP Details

article

README

🚀 🏈 足球数据 MCP 服务器

足球数据 MCP 服务器 是一个开源的 Model Context Protocol (MCP) 服务器，它连接到 SoccerDataAPI，能提供最新的足球比赛信息，还支持通过自然语言交互来查询数据。此服务器专为与支持 MCP 的客户端（如 Claude Desktop）配合使用而设计，允许用户借助大型语言模型（LLMs）检索足球数据。

🚀 快速开始

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

手动安装指南

克隆仓库：

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

安装依赖项：

pip install -r requirements.txt

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

API_KEY=your_api_key_here

运行服务器：

python server.py

配置 MCP 客户端

打开客户端的配置界面。
添加以下设置：

名称：MCP-Soccerdata
类型：football_data
地址：http://localhost:5000

✨ 主要特性

🏟️ 实时足球比赛洞察

MCP-Soccerdata 专注于提供 全球范围内正在进行的足球比赛的实时信息。用户可以通过自然语言提出问题，例如：

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

服务器会提供结构化的相关信息，具体包含以下详细分类：

- 比赛列表与基本信息

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

- 比赛详情

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

- 关键比赛事件

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

- 队伍阵容

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

- 赔率与投注信息

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

- 联赛元数据

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

⚠️ 重要提示

本服务器专注于实时、即将进行 和 最近结束的 比赛。

🎥 演示

mcp (3) (1)

💻 使用示例

基础用法

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。

mcp-soccer-data