AI导哈

足球数据协议服务器

一个为Claude AI提供实时足球数据（包括实时比分、联赛排名和比赛信息）的模型上下文协议服务器，专注于英超联赛，基于API-Football API构建。

  • by nawfel-dahmani
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 nawfel-dahmani/pl-mcp-server

使用说明

⚽ 英超MCP服务器

A. 模型上下文协议（MCP）服务器 这使克劳德人工智能能够实时访问足球数据——实时比分、积分榜和比赛信息——并专注于 英超联赛，由API-Football API提供动力。

作为人工智能超级大国挑战的一部分而构建：为克劳德提供与现实世界互动的真正工具。

🤖 AI能用它做什么？

连接后，Claude可以：

  • ⚽ 获取实时足球比分 来自全球任何正在进行的比赛
  • 📊 获取联赛排名 适用于英超、西甲、意甲、德甲等联赛
  • 🗣️ 回答自然语言问题 喜欢 “现在谁在PL中获胜？”

🛠️ 技术栈

技术 角色
Python 3.11+ 核心语言
FastMCP MCP服务器框架
httpx 异步HTTP请求
python-domainv neneneba API密钥管理
API-足球（RapidAPI） 足球数据源
Claude Desktop 用于测试的MCP客户端

📁 项目结构

pl-mcp-server/
├── tools/
│   ├── __init__.py
│   └── sports.py       # API-Football logic
├── server.py           # MCP server + tool definitions
├── .env                # API keys (gitignored)
├── requirements.txt
└── README.md

🚀 入门指南

1.克隆仓库

git clone https://github.com/nawfel-dahmani/pl-mcp-server.git
cd pl-mcp-server

2.创建虚拟环境

python -m venv venv

# Windows
venv\Scripts\activate

# Mac/Linux
source venv/bin/activate

3.安装依赖项

pip install -r requirements.txt

4.设置API密钥

创建一个 .env 根目录下的文件：

RAPIDAPI_KEY=your_key_here

获取免费钥匙 网站 rapidapi.com → 搜索 API-足球 → 订阅免费计划。

5.测试服务器

python server.py

如果它安静地运行，没有错误，它就会工作！ ✅

🔌 连接到克劳德桌面

  1. 打开克劳德桌面→ 设置→ 开发者→ 编辑配置
  2. 将以下内容添加到配置文件中：
{
  "mcpServers": {
    "pl-mcp-server": {
      "command": "FULL_PATH_TO\\venv\\Scripts\\python.exe",
      "args": ["FULL_PATH_TO\\server.py"]
    }
  }
}
  1. 重新启动克劳德桌面
  2. 寻找 pl-mcp服务器 在设置中→ 开发人员与a🟢 跑步 徽章

🧰 可用工具

工具 说明 参数
live_scores 立即获取所有实时足球比赛 无
standings 获取排行榜 league_id （int）， season （int）

普通联赛ID

联赛 ID
英超联赛 39
西甲联赛 140
意甲 135
德甲联赛 78
第1 61

💬 示例提示

连接到Claude Desktop后，请尝试：

"Are there any football matches happening right now?"
"Show me the Premier League standings for 2024"
"What's the La Liga table this season?"

📦 需求

mcp
httpx
python-dotenv

安装方式：

pip install -r requirements.txt

📄 许可证

MIT许可证——见 许可证 了解详情。

相关 MCP