MCP Soccer Data

🚀 🏈 足球數據 MCP 服務器

MCP-Soccerdata 是一個開源的 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

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

✨ 主要特性

🏟️ 即時足球比賽洞察

MCP-Soccerdata 專注於提供 全球範圍內正在進行的足球比賽的即時信息。用戶可以提出如下問題：

"現在有哪些足球比賽在進行？"
"告訴我巴黎聖日耳曼對陣阿斯頓維拉今天的預計首發陣容。"
"請告知我最近結束的比賽的比分和進球數。"

服務器會提供結構化的相關信息，具體包含以下詳細分類：

- 比賽列表與基本信息

• 全球正在舉行的全部比賽清單
• 主場球隊和客場球隊名稱
• 開賽時間和比賽日期
• 比賽場地信息
• 當前比分

- 比賽詳情

• 比賽狀態：已安排、進行中或已完成
• 進球分解：上半場、下半場、加時賽、點球大戰
• 最終結果：勝、平局或敗

- 關鍵比賽事件

• 進球情況（誰進的球、時間、方式）
• 替換情況
• 黃牌和紅牌
• 點球判罰

- 隊伍陣容

• 先發 XI 人名單
• 替補球員信息
• 傷病狀態
• 陣型安排

- 賠率與投注信息

• 勝、平、負賠率
• 進球數上下限賠率
• 比分讓球賠率

- 聯賽元數據

• 聯賽名稱
• 國家
• 競賽形式（如：常規賽季、淘汰賽階段）

⚠️ 重要提示

該服務器專注於 即時、即將進行 和 最近結束的 比賽。

💻 使用示例

基礎用法

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。