Mcp Soccer Data

Mcp Soccer Data

🚀 🏈 足球数据 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)

手动安装指南

  1. 克隆仓库:
git clone https://github.com/yeonupark/mcp-soccer-data.git
cd mcp-soccer-data
  1. 安装依赖项:
pip install -r requirements.txt
  1. 设置环境变量: 创建一个 .env 文件并添加以下内容:
API_KEY=your_api_key_here
  1. 运行服务器:
python server.py

配置 MCP 客户端

  1. 打开客户端的配置界面。
  2. 添加以下设置:
  • 名称: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。

  • 0 关注
  • 0 收藏,7 浏览
  • system 提出于 2025-09-21 05:00

相似服务问题