OpenDota MCP 服务器

一个用于访问 OpenDota API 数据的模型上下文协议 (MCP) 服务器实现。该服务器使 LLM 和 AI 助手能够通过标准接口检索实时的 Dota 2 统计数据、比赛数据、玩家信息等。

特性

• 访问玩家个人资料、统计数据和比赛历史
• 检索详细的比赛信息
• 查找职业选手和战队
• 获取英雄统计数据和排名
• 按名称搜索玩家
• 还有更多！

安装

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

# 选项 1：自动设置（适用于 bash、zsh 和其他 shell）
./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，假设您已经克隆了 repo 并设置了 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