OpenDota MCP 服务器

一个用于访问 OpenDota API 数据的 Model Context Protocol (MCP) 服务器实现。此服务器允许大语言模型（LLMs）和 AI 助手通过标准接口获取实时 Dota 2 统计信息、比赛数据、玩家信息等。

特性

• 访问玩家资料、统计信息和比赛历史
• 获取详细的比赛信息
• 查找职业玩家和队伍
• 获取英雄统计数据和排名
• 按名称搜索玩家
• 以及其他更多功能！

安装

# 克隆仓库
git clone https://github.com/asusevski/opendota-mcp-server.git
cd opendota-mcp-server

# 方案 1：自动化设置（适用于 bash、zsh 等外壳）
./scripts/setup_env.sh

# 方案 2：手动安装与 uv
uv add pyproject.toml

# 开发依赖项
uv pip install -e ".[dev]"

使用方法

设置环境

1. （可选但推荐）在 https://www.opendota.com/api-keys 创建一个 OpenDota API 密钥。
2. 将您的 API 密钥设置为环境变量：

export OPENDOTA_API_KEY=your_api_key_here

直接运行服务器

python -m src.opendota_server.server

使用 Claude Desktop 运行服务器

请参考：https://modelcontextprotocol.io/quickstart/user

如果使用 WSL，假设您已克隆仓库并设置好 Python 环境，这是我为 claude_desktop_config.json 编写的示例：

{
  "mcpServers": {
    "opendota": {
      "command": "wsl.exe",
      "args": [
        "--",
        "bash",
        "-c",
        "cd ~/opendota-mcp-server && source .venv/bin/activate && python src/opendota_server/server.py"
      ]
    }
  }
}

使用示例客户端

python -m src.client

具体包含的工具：

• get_player_by_id：通过 ID 获取玩家信息
• get_player_recent_matches：获取玩家最近的比赛记录
• get_match_data：获取特定比赛的详细数据
• get_player_win_loss：获取玩家的胜率/败率统计
• get_player_heroes：获取玩家最常使用的英雄
• get_hero_stats：获取英雄统计数据
• search_player：按名称搜索玩家
• get_pro_players：获取职业玩家列表
• get_pro_matches：获取最近的职业比赛
• get_player_peers：获取与指定玩家一起玩过的其他玩家
• get_heroes：获取所有 Dota 2 英雄的列表
• get_player_totals：获取玩家的整体统计信息总和
• get_player_rankings：获取玩家的英雄排名
• get_player_wordcloud：获取玩家在聊天中使用频率最高的词语
• get_team_info：获取队伍的信息
• get_public_matches：获取最近的公开比赛
• get_match_heroes：获取特定比赛中使用的英雄列表

许可证

MIT