arena-hero-mcp
The arena-hero-mcp server bridges your AI client to the browser's IndexedDB for the game arena-hero, enabling real-time queries of explored map cells (resources and obstacles) via WebSocket. It provides the following tools:
list_resources — Returns coordinates of all explored resource nodes. Data is refreshed on each call but may be stale.
list_obstacles — Returns coordinates of permanent obstacles. This data is reliable.
get_all_cells — Lists all non-empty cells (both resources and obstacles) in one call.
snapshot_info — Shows snapshot metadata: cell count, namespace, update time, kind distribution, and browser connection status.
refresh — Forces the browser to re-read IndexedDB and push an updated snapshot.
get_userscript — Provides the full Tampermonkey userscript for installation, even without an active browser connection.
The server establishes a WebSocket connection to the browser, retrieves data on demand, runs persistently until the client exits, and automatically reconnects if the connection drops.
Provides the Tampermonkey userscript that bridges the browser to the MCP server, enabling AI to query the arena-hero game's exploration memory (resource/obstacle coordinates) stored in IndexedDB.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@arena-hero-mcpList all resource coordinates I've explored"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
arena-hero MCP
让 AI 读取 Arena Hero 浏览器中的探索地图、移动目标、指令上下文,并预览路线。无需修改 Web 代码;浏览器数据由 Tampermonkey 脚本转发给本地 MCP server。
安装
npx -y arena-hero-mcp install <agent> # 当前项目
npx -y arena-hero-mcp install <agent> --global # 全局支持 claude、claude-desktop、cursor、windsurf、cline、continue 和 codex。claude-desktop、codex 仅支持 --global。安装后重启 agent。
手动配置:
{
"mcpServers": {
"arena-hero-mcp": {
"command": "npx",
"args": ["-y", "arena-hero-mcp"]
}
}
}Related MCP server: mc-mcp-server
浏览器配置
安装 Tampermonkey 或 Violentmonkey。
调用 MCP 工具
get_userscript,将返回的脚本全文粘贴为新用户脚本并保存。在
https://app.arenahero.io的站点设置中允许“不安全内容”,使 HTTPS 页面可以连接本机ws://127.0.0.1:7790。登录并打开
https://app.arenahero.io/arena。右上角显示📡 已连 MCP 桥即可使用。
脚本自动识别当前用户名,无需修改配置。
工具
工具 | 用途 |
| 查询已探索的 |
| 查询 Web 保存的跨 Tick 移动目标 |
| 查询当前 Agent、Manual 和合并后的有效指令 |
| 查询 Tick、连接阶段、指令窗口剩余时间和移动目标 |
| 按 Web 规则预览对象到目标坐标的路线 |
| 查询探索记忆中的资源坐标 |
| 查询已知永久障碍坐标 |
| 查询所有非空探索记忆格 |
| 查询版本、namespace、格子统计和浏览器连接状态 |
| 强制浏览器重读 IndexedDB |
| 获取当前版本的用户脚本 |
首次安装可调用 snapshot_info 验证:
{
"browserConnected": true,
"versionMatch": true
}边界
未探索区域没有数据。
RESOURCE是探索记忆,可能已被采集、补充或移位;实时资源以游戏状态为准。preview_route在油猴脚本中复刻 Web 的视野、地形、占位和移动规则。selected_object_id无稳定浏览器资源来源,因此固定返回null。关闭 Arena 页面后浏览器桥会断开。
排错
browserConnected: false:确认 MCP server 已启动、Arena 页面已打开,并允许了不安全内容。“无探索数据”:先进入 Arena 探索地图。
脚本版本不匹配:重新调用
get_userscript并覆盖旧用户脚本。EADDRINUSE:端口 7790 已被另一实例占用。Codex 日志出现
listen EPERM:当前沙箱禁止监听本机端口,需要在允许本地监听的环境中运行 MCP server。
开发
需要 Node.js 18+。
npm install
PORT=17790 npm testPORT 默认是 7790;修改后需要同步修改用户脚本中的 WS_URL。
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityDmaintenanceA minimal WebSocket-based MCP server implementation that enables modern tool integrations with VSCode, Claude, and other applications.Last updated6ISC
- Alicense-qualityDmaintenanceEnables AI-driven interactions with Minecraft through a WebSocket-based server and MCP protocol, allowing external MCP clients and in-game chat to trigger AI tools.Last updated4MIT
- Alicense-qualityDmaintenanceMCP server that bridges Unity with AI agents, enabling scene inspection, C# code execution, and screenshot capture via WebSocket communication.Last updatedMIT
- Alicense-qualityDmaintenanceA local MCP server that provides shared, real-time context across multiple AI agents via WebSocket and MCP resource notifications, enabling collaborative workspaces, memory, tasks, and messaging.Last updated111MIT
Related MCP Connectors
Hosted MCP server connecting claude.ai, ChatGPT and other AI apps to your own computer
Cloud-hosted MCP server for durable AI memory
MCP server for AI dialogue using various LLM models via AceDataCloud
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/vhxubo/arena-hero-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server