Dota 2 Match Analysis Server

Build Status Documentation Python 3.12

FastMCP server for Dota 2 match analysis using replay files and OpenDota API.

Built-in coaching instructions guide LLMs to provide meaningful analysis - pattern recognition, objective rotations, networth swings linked to teamfights, and actionable coaching advice.

Quick Start

Local

git clone https://github.com/DeepBlueCoding/mcp-replay-dota2.git
cd mcp-replay-dota2
uv sync
uv run python dota_match_mcp_server.py

Docker

docker build -t dota2-mcp-server .
docker run -p 8081:8081 dota2-mcp-server --transport sse
# Connect to http://localhost:8081/sse

What It Does

• Resources: Static reference data (heroes, map, pro players/teams)
• Tools: Match analysis (deaths, combat log, objectives, timelines, drafts)
• Instructions: Built-in coaching guidance for meaningful LLM responses

See full documentation for API reference and integration guides.

Development

uv run pytest                       # Run tests
uv run pytest -m "not integration"  # Skip slow tests

License

MIT