OpenDota MCP Server

OpenDota MCP 服务

用于访问 OpenDota API 数据的模型上下文协议（MCP）服务实现。此服务通过标准接口，让大模型和 AI 助手能够检索实时 Dota 2 统计数据、比赛数据、玩家信息等。

功能

• 访问玩家档案、统计数据和比赛历史
• 检索详细的比赛信息
• 查询职业选手和战队
• 获取英雄统计数据和排名
• 按名称搜索玩家
• 以及更多！

安装

通过 Smithery 安装

通过 Smithery 自动为 Claude Desktop 安装 OpenDota API 服务：

npx -y @smithery/cli install @asusevski/opendota-mcp-server --client claude

手动安装

# Clone the repository
git clone https://github.com/asusevski/opendota-mcp-server.git
cd opendota-mcp-server

# Option 1: Automated setup (works with bash, zsh, and other shells)
./scripts/setup_env.sh

# Option 2: Manual installation with uv
uv add pyproject.toml

# For development dependencies
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