Asusevski Opendota MCP Server

🚀 OpenDota MCP 服务器

OpenDota MCP 服务器是一个基于 Model Context Protocol (MCP) 的实现，旨在为大语言模型（LLMs）和 AI 助手提供标准接口，以便它们能够轻松访问 OpenDota API 中的实时 Dota 2 统计信息、比赛数据、玩家信息等。

🚀 快速开始

OpenDota MCP 服务器允许大语言模型和 AI 助手通过标准接口获取实时 Dota 2 数据。以下是使用此服务器的基本步骤：

1. 安装服务器（具体安装步骤见“📦 安装指南”）。
2. 设置环境变量（具体设置方法见“💻 使用示例”）。
3. 运行服务器，开始获取数据。

✨ 主要特性

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

📦 安装指南

# 克隆仓库
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 许可证。