Obinopaul Soccer MCP Server

🚀 足球 MCP 服務器

這是一個藉助 API-Football 服務實現模型上下文協議（MCP）的足球數據分析服務器。它能提供全面的足球數據，還支持與 Claude Desktop 集成，為用戶帶來便捷的足球數據查詢與分析體驗。

🚀 快速開始

此足球 MCP 服務器基於 API-Football 構建，通過 MCP 協議為用戶提供豐富的足球相關數據和功能。用戶可以通過配置將此服務器集成到 Claude Desktop 中，以獲取即時或歷史足球比賽數據、球隊信息以及其他相關統計。

✨ 主要特性

核心功能

• 即時數據：獲取當前進行的足球比賽的即時數據。
• 歷史數據：查詢過去比賽的結果和詳細統計數據。
• 球隊信息：獲取特定球隊的基本信息、陣容以及歷史表現。
• 聯賽排名：查看各個足球聯賽的最新積分榜。
• 賽事日曆：獲取未來即將進行的足球比賽安排。

高級功能

• 數據分析：對比賽數據進行統計和分析，生成可視化報告。
• 比分預測：基於歷史數據提供簡單的比分預測模型。
• 新聞更新：獲取與特定球隊或聯賽相關的最新新聞動態。

📦 安裝指南

安裝依賴

pip install -r requirements.txt

運行服務器

python soccer_server.py

配置示例

Docker 方式運行

1. 克隆倉庫：

   git clone https://github.com/obinopaul/soccer-mcp-server.git
   cd soccer-mcp-server
   

2. 安裝依賴：

   pip install -r requirements.txt
   

3. 構建 Docker 鏡像：

   docker build -t soccer_server .
   

4. 運行容器並配置環境變量：

   docker run -d -p 5000:5000 -e RAPID_API_KEY_FOOTBALL=your_api_key_here --name soccer_server soccer_server
   

直接運行 Python 腳本

1. 配置環境變量：

   export RAPID_API_KEY_FOOTBALL=your_api_key_here
   

2. 在 claude_desktop_config.json 中添加配置：

   {
     "mcpServers": {
       "soccer_server": {
         "command": "/path/to/your/python",
         "args": [
           "/path/to/soccer_server.py"
         ],
         "env": {
           "RAPID_API_KEY_FOOTBALL": "your_api_key_here"
         }
       }
     }
   }
   

🔧 技術細節

使用的技術

• API-Football：通過 RapidAPI 提供足球數據。
• MCP 協議：實現統一的 API 接口。
• Pydantic：用於輸入驗證和數據建模。
• Requests：處理 HTTP 請求。

📄 許可證

此 MCP 服務器根據 MIT License 開源。