Skip to content

v1.0.0 - First Stable Release

Choose a tag to compare

@DBC-Juanma DBC-Juanma released this 08 Dec 03:40
· 18 commits to master since this 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 abilities
  • dota2://map - Map geometry with towers, barracks, neutral camps, runes
  • dota2://pro/players - Pro player database
  • dota2://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.py

Requirements

  • Python 3.12+
  • ~400MB disk space per replay file