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 开源。