OpenDota MCP Server

OpenDota MCP Server

site icon
2025.03.13 4
Python游戏数据分析玩家信息查询职业比赛数据追踪英雄使用统计娱乐功能
OpenDota MCP Server 是一个基于模型上下文协议(MCP)的服务器实现,用于访问 OpenDota API 数据。该服务器使 LLMs 和 AI 助手能够通过标准接口获取实时的 Dota 2 统计数据、比赛数据、玩家信息等。
View on GitHub

Overview

基本能力

产品定位

OpenDota MCP Server 主要用于提供 Dota 2 游戏相关的实时数据和统计信息,服务于游戏数据分析、玩家信息查询等场景。

核心功能

  • 访问玩家资料、统计数据和比赛历史
  • 检索详细的比赛信息
  • 查找职业玩家和战队
  • 获取英雄统计数据和排名
  • 按名称搜索玩家

适用场景

  • 游戏数据分析
  • 玩家信息查询
  • 职业比赛数据追踪
  • 英雄使用统计

工具列表

  • get_player_by_id - 通过账户 ID 检索玩家信息
  • get_player_recent_matches - 获取玩家最近的比赛
  • get_match_data - 获取特定比赛的详细数据
  • get_player_win_loss - 获取玩家的胜负统计
  • get_player_heroes - 获取玩家最常使用的英雄
  • get_hero_stats - 获取英雄统计数据
  • search_player - 按名称搜索玩家
  • get_pro_players - 获取职业玩家列表
  • get_pro_matches - 获取最近的职业比赛
  • get_player_peers - 获取与指定玩家一起玩过的玩家
  • get_heroes - 获取所有 Dota 2 英雄列表
  • get_player_totals - 获取玩家的总体统计数据
  • get_player_rankings - 获取玩家英雄排名
  • get_player_wordcloud - 获取玩家在聊天中最常用的词
  • get_team_info - 获取战队信息
  • get_public_matches - 获取最近的公开比赛
  • get_match_heroes - 获取特定比赛中使用的英雄

常见问题解答

  • 如何获取 OpenDota API 密钥? 访问 https://www.opendota.com/api-keys 创建 API 密钥。
  • 如何设置环境变量? 使用命令 export OPENDOTA_API_KEY=your_api_key_here 设置 API 密钥。

使用教程

使用依赖

  • 需要安装 Python 环境
  • 需要 OpenDota API 密钥(可选但推荐)

安装教程

# 克隆仓库
git clone https://github.com/asusevski/opendota-mcp-server.git
cd opendota-mcp-server

# 选项 1: 自动设置(适用于 bash, zsh 和其他 shell)
./scripts/setup_env.sh

# 选项 2: 使用 uv 手动安装
uv add pyproject.toml

# 安装开发依赖
uv pip install -e ".[dev]"

调试方式

# 直接运行服务器
python -m src.opendota_server.server

# 使用示例客户端
python -m src.client

许可证

该项目遵循 MIT 开源许可条款。