AI导哈

足球数据查询服务

一个用于访问Transfermarkt足球数据的模型上下文协议（MCP）服务器，提供俱乐部、球员和比赛信息的搜索与查询功能。

  • by emreclsr
  • Python
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 emreclsr/transfermarkt-mcp

使用说明

Transfermarkt MCP服务器

用于访问Transfermarkt足球数据的模型上下文协议（MCP）服务器。

特性

  • 🔍 按名称搜索足球俱乐部
  • 📊 获取详细的俱乐部资料
  • 👥 检索俱乐部球员名册
  • 🏆 搜索并获取竞争信息
  • ⚽ 搜索单个玩家
  • 📄 搜索结果分页支持
  • 🔧 基于季节的玩家筛选

安装

  1. 克隆存储库：
git clone https://github.com/emreclsr/transfermarkt-mcp.git
cd transfermarkt-mcp
  1. 安装依赖项：
pip install -r requirements.txt

或

poetry install
  1. 设置环境变量：
cp .env.example .env
# Edit .env with your API configuration

配置

创建一个 .env 文件包含：

TRANSFERMARKT_API_BASE_URL=https://transfermarkt-api.fly.dev
LOG_LEVEL=INFO

用法

运行MCP服务器

python -m src.transfermarkt_mcp.main

可用工具

俱乐部工具

  • search_clubs(club_name, page_number=1) -搜索俱乐部
  • get_club_profile(club_id) -获取俱乐部详细信息
  • get_club_players(club_id, season_id=None) -获得俱乐部球员

竞争工具

  • search_competitions(competition_name, page_number=1) -按名称搜索比赛
  • get_competition_clubs(competition_id) -让所有俱乐部参加特定的比赛

玩家工具

  • search_players(player_name, page_number=1) -按名字搜索玩家
  • get_player_by_id(player_id) -获取特定玩家的详细信息

发展

运行测试

pytest tests/

代码质量

black src/
flake8 src/

Claude桌面配置示例

{
  "mcpServers": {
    "transfermarkt": {
      "command": "your-uv-location/uv",
      "args": [
        "run",
        "--with",
        "fastmcp",
        "--with",
        "requests",
        "fastmcp",
        "run",
        "your-workdir/transfermarkt-mcp/src/transfermarkt_mcp/main.py"
      ],
      "cwd": "your-workdir/transfermarkt-mcp/src",
      "env": {
        "BASE_URL": "https://transfermarkt-api.fly.dev",
        "PYTHONPATH": "your-workdir/transfermarkt-mcp/src"
      }
    }
  }
}

许可证

MIT许可证

相关 MCP