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