MCP：AI 助手中的 RealmPulse 统计

RealmPulse 通过 MCP（Model Context Protocol）发布玩家统计 — 您的 AI 助手可以在聊天中直接回答关于职业、等级、区域和具体玩家的问题。访问免费；完整工具集需要免费 API 密钥。

连接

服务器为无会话 HTTP — 在任意 MCP 客户端中填入其 URL 即可。例如 Claude Code：

claude mcp add --transport http realmpulse https://foragerstats.com/mcp

或通用 JSON 配置（Claude Desktop、Cursor 等）：

{ "mcpServers": { "realmpulse": { "url": "https://foragerstats.com/mcp" } } }

访客访问（无需密钥）

无需注册即可使用一个工具 — get_class_distribution：按职业与阵营的玩家分布，支持游戏模式过滤。限速为每分钟 30 次请求。

免费 API 密钥

1. 注册：页面顶部的“注册”按钮。
2. 打开个人资料并创建 API 密钥 — 密钥只显示一次，请保存。
3. 在 /mcp 请求中添加头 Authorization: Bearer <key>（多数客户端在配置的 headers 字段中）。

{ "mcpServers": { "realmpulse": { "url": "https://foragerstats.com/mcp", "headers": { "Authorization": "Bearer rp_..." } } } }

工具

• get_class_distribution — 按职业与阵营的玩家分布（无需密钥）。
• search_players — 按名字、职业、区域搜索玩家 — 注册后可用。
• get_level_distribution — 1–60 级玩家数量 — 注册后可用。
• get_zone_stats — 最热闹的区域 — 注册后可用。
• upload_saved_variables — 上传你的 NearbySpy.lua 到共享数据采集（需要 API 密钥）

mode 过滤器只接受三个值：pve、pvp、hardcore。其他值会返回列明允许值的明确错误；不带 mode 则返回所有模式的数据。

请求示例

POST /mcp MCP-Protocol-Version: 2026-07-28 Mcp-Method: tools/call Mcp-Name: get_class_distribution { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "get_class_distribution", "arguments": { "mode": "pve" } } }

限速：无密钥每分钟 30 次，有密钥每分钟 120 次。超出时服务器返回 429 — 请稍后重试。