Asusevski Opendota MCP Server

🚀 OpenDota MCP 服務器

OpenDota MCP 服務器是一個用於訪問 OpenDota API 數據的 Model Context Protocol (MCP) 服務器實現。它允許大語言模型（LLMs）和 AI 助手通過標準接口獲取即時 Dota 2 統計信息、比賽數據、玩家信息等，為相關應用提供了便捷的數據獲取途徑。

🚀 快速開始

本服務器允許大語言模型（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