Transfermarkt MCP服务器
用于访问Transfermarkt足球数据的模型上下文协议（MCP）服务器。
特性
- 🔍 按名称搜索足球俱乐部
- 📊 获取详细的俱乐部资料
- 👥 检索俱乐部球员名册
- 🏆 搜索并获取竞争信息
- ⚽ 搜索单个玩家
- 📄 搜索结果分页支持
- 🔧 基于季节的玩家筛选
安装
- 克隆存储库：
git clone https://github.com/emreclsr/transfermarkt-mcp.git
cd transfermarkt-mcp- 安装依赖项：
pip install -r requirements.txt或
poetry install- 设置环境变量：
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许可证