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