Repository navigation
v1.0.0 - First Stable Release
Dota 2 MCP Server v1.0.0
First stable release of the Dota 2 MCP Server for match analysis using replay files.
Features
MCP Resources
dota2://heroes/all- All Dota 2 heroes with stats and abilitiesdota2://map- Map geometry with towers, barracks, neutral camps, runesdota2://pro/players- Pro player databasedota2://pro/teams- Pro team database with rosters
Match Analysis Tools (30+)
- Combat:
get_hero_deaths,get_combat_log,get_fight_combat_log(with highlights!) - Timeline:
get_match_timeline,get_stats_at_minute - Objectives:
get_objective_kills,get_courier_kills,get_rune_pickups - Fights:
list_fights,get_teamfights,get_fight,get_fight_replay - Farming:
get_farming_pattern- minute-by-minute breakdown - Rotations:
get_rotation_analysis- rune correlation, fight outcomes
Fight Highlights
get_fight_combat_log now returns key teamfight moments:
- Multi-hero abilities (Chronosphere, Black Hole hitting 2+ heroes)
- Kill streaks (Double kill → Rampage)
- Team wipes (Aces)
- Fight initiation detection
Pro Scene Integration
- Fuzzy search for players and teams
- Series grouping (Bo1/Bo3/Bo5)
- Player signature heroes and roles
Developer Experience
- 40+ Pydantic response models with Field descriptions
- Comprehensive MkDocs documentation
- Parallel-safe tool hints for LLM optimization
Documentation
📖 Full documentation: https://deepbluecoding.github.io/mcp_replay_dota2/
Installation
# Using uv (recommended)
uv pip install git+https://github.com/DeepBlueCoding/mcp_replay_dota2.git@v1.0.0
# Or clone and run
git clone https://github.com/DeepBlueCoding/mcp_replay_dota2.git
cd mcp_replay_dota2
uv sync
uv run python dota_match_mcp_server.pyRequirements
- Python 3.12+
- ~400MB disk space per replay file