Asusevski Opendota MCP Server

🚀 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