ismaelMoreau/Dota_2_MCP_Server_

Dota 2 MCP Server & Discord Coach Bot

This project provides a Dota 2 Game State Integration (GSI) MCP server and a Discord bot that coaches you with real-time rune spawn advice.

Features

• Receives live Dota 2 GSI data and exposes it as MCP resources and HTTP endpoints
• Discord bot announces rune spawn times in your channel (with TTS support)
• Dockerized and ready for local or cloud deployment

Installation & Setup

1. Clone the Repository

git clone <your-repo-url>
cd dota mcp

2. Create a Python Virtual Environment

python3 -m venv .venv
source .venv/bin/activate

3. Install Requirements

pip install -r requirements.txt

4. (Optional) Build & Run with Docker

docker build -t dota2gsi-mcp .
docker run --name dota2gsi-mcp-server -p 5000:5000 -v "$(pwd):/app" --restart unless-stopped dota2gsi-mcp

5. Set Up Dota 2 GSI

• Follow the instructions in note.md to configure Dota 2 to POST game state to your server.

6. Set Up the Discord Bot

• Create a bot in the Discord Developer Portal
• Copy your bot token and invite the bot to your server with the Send Messages and Send TTS Messages permissions
• Get your channel ID (right-click channel > Copy ID)
• Set environment variables:

export DISCORD_TOKEN=your-bot-token
export DISCORD_CHANNEL_ID=your-channel-id

• Run the bot:

python dota_coach_bot.py

Usage

• The MCP server will expose endpoints at http://localhost:5000/ and MCP resources at /mcp
• The Discord bot will announce rune spawn times in your channel

Project Structure

• dota2gsi_mcp_server.py — MCP server and FastAPI endpoints
• dota_coach_bot.py — Discord bot for rune timing advice
• requirements.txt — Python dependencies
• Dockerfile — Docker build instructions
• note.md — Dota 2 GSI setup guide
• .gitignore — Files and folders to ignore in git

License

MIT