Metadata-Version: 2.4
Name: mcp-replay-dota2
Version: 1.0.6
Summary: Model Context Protocol server for Dota 2 match analysis using replay files
License-Expression: MIT
Project-URL: Homepage, https://github.com/DeepBlueCoding/mcp-replay-dota2
Project-URL: Documentation, https://deepbluecoding.github.io/mcp-replay-dota2/
Project-URL: Repository, https://github.com/DeepBlueCoding/mcp-replay-dota2
Project-URL: Bug Tracker, https://github.com/DeepBlueCoding/mcp-replay-dota2/issues
Keywords: dota2,mcp,model-context-protocol,replay,analysis,esports
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Games/Entertainment
Requires-Python: <3.13,>=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastmcp>=2.12.3
Requires-Dist: python-opendota-sdk>=7.39.5.2
Requires-Dist: requests>=2.32.5
Requires-Dist: python-manta>=1.4.5.2
Requires-Dist: aiohttp>=3.13.2
Requires-Dist: diskcache>=5.6.3
Requires-Dist: anthropic>=0.75.0
Provides-Extra: dev
Requires-Dist: ipykernel>=6.30.1; extra == "dev"
Requires-Dist: jupyter>=1.1.1; extra == "dev"
Requires-Dist: pip>=25.0; extra == "dev"
Requires-Dist: pytest>=8.4.2; extra == "dev"
Requires-Dist: pytest-asyncio>=1.3.0; extra == "dev"
Dynamic: license-file

# MCP Dota 2 Match Analysis Server

[![Build Status](https://github.com/DeepBlueCoding/mcp-replay-dota2/actions/workflows/test.yml/badge.svg)](https://github.com/DeepBlueCoding/mcp-replay-dota2/actions/workflows/test.yml)
[![Documentation](https://img.shields.io/badge/docs-gh--pages-blue.svg)](https://deepbluecoding.github.io/mcp-replay-dota2/)
[![Python 3.12](https://img.shields.io/badge/python-3.12-blue.svg)](https://www.python.org/downloads/)

[FastMCP](https://github.com/jlowin/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

```bash
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

```bash
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](https://deepbluecoding.github.io/mcp-replay-dota2/) for API reference and integration guides.

## Development

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

## License

MIT
