https://github.com/asusevski/opendota-mcp-server
https://github.com/asusevski/opendota-mcp-server
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/asusevski/opendota-mcp-server
- Owner: asusevski
- Created: 2025-03-02T23:28:59.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-03-12T22:32:02.000Z (3 months ago)
- Last Synced: 2025-03-12T23:27:20.267Z (3 months ago)
- Language: Python
- Size: 39.1 KB
- Stars: 4
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-mcp-servers - OpenDota - Provides real-time Dota 2 statistics and match data via a Model Context Protocol server (Table of Contents / Gaming)
- awesome-mcp-servers - OpenDota - Provides real-time Dota 2 statistics and match data via a Model Context Protocol server (Table of Contents / Gaming)
README
# OpenDota MCP Server
A Model Context Protocol (MCP) server implementation for accessing OpenDota API data. This server enables LLMs and AI assistants to retrieve real-time Dota 2 statistics, match data, player information, and more through a standard interface.
## Features
- Access player profiles, statistics, and match history
- Retrieve detailed match information
- Look up professional players and teams
- Get hero statistics and rankings
- Search for players by name
- And more!
## Installation
```bash
# Clone the repository
git clone https://github.com/asusevski/opendota-mcp-server.git
cd opendota-mcp-server
# Option 1: Automated setup (works with bash, zsh, and other shells)
./scripts/setup_env.sh
# Option 2: Manual installation with uv
uv add pyproject.toml
# For development dependencies
uv pip install -e ".[dev]"
```
## Usage
### Setting up your environment
1. (Optional but recommended) Create an OpenDota API key at https://www.opendota.com/api-keys
2. Set your API key as an environment variable:
```bash
export OPENDOTA_API_KEY=your_api_key_here
```
### Running the server directly
```bash
python -m src.opendota_server.server
```
### Running the server with Claude Desktop
Follow this: https://modelcontextprotocol.io/quickstart/user
If you use WSL, assuming you have cloned the repo and set up the python environment, this is how I wrote the claude_desktop_config.json:
```json
{
"mcpServers": {
"opendota": {
"command": "wsl.exe",
"args": [
"--",
"bash",
"-c",
"cd ~/opendota-mcp-server && source .venv/bin/activate && python src/opendota_server/server.py"
]
}
}
}
```
### Using the example client
```bash
python -m src.client
```
### Specific tools included:
- get_player_by_id - Retrieve player information by account ID
- get_player_recent_matches - Get recent matches for a player
- get_match_data - Get detailed data for a specific match
- get_player_win_loss - Get win/loss statistics for a player
- get_player_heroes - Get a player's most played heroes
- get_hero_stats - Get statistics for heroes
- search_player - Search for players by name
- get_pro_players - Get list of professional players
- get_pro_matches - Get recent professional matches
- get_player_peers - Get players who have played with a specified player
- get_heroes - Get list of all Dota 2 heroes
- get_player_totals - Get player's overall stats totals
- get_player_rankings - Get player hero rankings
- get_player_wordcloud - Get most common words used by player in chat
- get_team_info - Get information about a team
- get_public_matches - Get recent public matches
- get_match_heroes - Get heroes played in a specific match
## License
MIT