Transfermarkt MCP Server

这是一个用于访问Transfermarkt足球数据的Model Context Protocol (MCP)服务器。

特性

• 🔍 按名称搜索足球俱乐部
• 📊 获取详细的俱乐部资料
• 👥 获取俱乐部球员名单
• 🏆 搜索并获取比赛信息
• ⚽ 搜索个别球员
• 📄 对搜索结果提供分页支持
• 🔧 根据赛季筛选球员

安装

1. 克隆仓库：

git clone https://github.com/emreclsr/transfermarkt-mcp.git
cd transfermarkt-mcp

2. 安装依赖：

pip install -r requirements.txt

或

poetry install

3. 设置环境变量：

cp .env.example .env
# 使用您的API配置编辑.env文件

配置

创建一个.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 Desktop配置示例

{
  "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许可证