关于 Runescape Wiki Mcp
面向 RuneScape 3 玩家及 AI 助手的数据服务,涵盖 Grand Exchange 价格、排行榜和 Wiki 内容,并提供历史走势与扣税后的倒卖估算。
主要功能
- 01Grand Exchange 实时及历史价格
- 02物品详情与扣税倒卖估算
- 03公开 RS3 排行榜查询
- 04RuneScape Wiki 搜索与数据
- 05任务和活动规划
适用场景
- 01查看物品指导价及近期变化
- 02估算物品倒卖扣税后的利润
- 03查询玩家技能或任务进度
- 04研究物品信息并规划游戏目标
MCP 相关
通过 stdio 或 Streamable HTTP 向 MCP 客户端提供 RuneScape 3 价格、排行榜、Wiki、任务和规划工具。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://runescape-wiki-mcp.fly.dev/mcpclaude mcp add --transport http runescape-wiki https://runescape-wiki-mcp.fly.dev/mcp{"mcpServers":{"runescape-wiki":{"type":"http","url":"https://runescape-wiki-mcp.fly.dev/mcp"}}}在 Cursor 中打开{"servers":{"runescape-wiki":{"type":"http","url":"https://runescape-wiki-mcp.fly.dev/mcp"}}}在 VS Code 中打开{"mcpServers":{"runescape-wiki":{"type":"http","url":"https://runescape-wiki-mcp.fly.dev/mcp"}}}{"mcpServers":{"runescape-wiki":{"serverUrl":"https://runescape-wiki-mcp.fly.dev/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
12| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| limit | integer | 否 | 返回的最大匹配数(默认值为 5) |
| query | string | 是 | 要搜索的物品名称或部分名称 |
详细介绍
RuneScape 3 MCP 服务
询问物品价值、扣除税费后转卖是否仍有利润,以及接下来该练什么。
将 Claude、ChatGPT、Cursor 和其他助手连接到 RuneScape 3 大交易所的指导价格、7–90 天历史记录、扣除 2% 税费后的转卖计算、公开 RS3 天梯数据和 Wiki 页面。仅支持 RS3。本项目非官方,与 Jagex 或 RuneScape Wiki 无关。
由独立团队 Birdwell Labs 开发的项目。不代表获得 Jagex 或 Weird Gloop 的批准。支持与权利相关问题 · 许可与来源审查。
默认价格为 Jagex 指导价格和 Weirdgloop 历史数据。它们会滞后于游戏内市场。询问报告的即时买入/卖出价格,可使用 prices.runescape.wiki 上单独提供的 RS3 交易数据源。
可以询问的问题
- Noxious scythe 的指导价格是多少?过去 30 天价格如何变化?
- 比较 Noxious scythe、Dragon rider lance 和 Abyssal whip。
- 估算转卖 100 把 Dragon rider lance 扣税后的利润。
- 查询我的属性,并告诉我最薄弱、最值得训练的技能。普通模式。
- 查找 Abyssal whip 特殊攻击的 RuneScape Wiki 来源链接。
服务会回答有关你指定物品的问题,不会为整个大交易所的物品排名。
价格问题会使用 lookup_item、get_item_details 当前数据视图、get_price_series 历史数据视图和 estimate_flip。属性问题会在所选的普通、铁人或硬核排行榜上使用 get_player_stats;助手会根据这些等级给出训练建议。Wiki 问题会先使用 search_wiki,再使用 get_wiki_page_content。
Wiki 页面默认返回来源链接。仅对经过审查的修订版本提供文章文本;如果不提供文本,服务不会生成文章摘要。
访问与数据处理
此服务会读取公开 API 并执行计算。它不会连接游戏客户端、控制角色、进行交易,也不会要求提供 Jagex 密码、会话 Cookie 或银行 PIN。查询玩家名称时,会将提供的名称发送到 Jagex 的公开天梯数据端点。
你的助手会接收工具结果,并可能据此生成回答。助手自身的隐私、数据保留和模型训练设置另行适用;本项目无法保证 AI 提供商如何处理这些结果。采取行动前,请查看链接的来源。
使用托管服务前,请参阅隐私政策。可选诊断功能可能会接收请求上下文;启用 DEBUG 后,可能会打印工具参数和返回数据。请勿提交机密信息,或任何你不希望服务和 AI 提供商处理的信息。
连接
托管端点:https://runescape-wiki-mcp.fly.dev/mcp
隐私政策说明了涉及的工具请求数据、诊断信息和服务提供商。
无需服务账号、API 密钥、游戏登录信息或本地安装。使用无需身份验证的 Streamable HTTP。
Claude 设置
- 打开 Customize → Connectors,然后选择 + Add → Add custom connector。
- 将其命名为 RuneScape Wiki MCP,并输入上方托管端点。
- 系统询问身份验证方式时,选择 No sign in,然后完成连接器添加。
- 在聊天中通过 + → Connectors 启用它,并询问:“Abyssal whip 在 RS3 中的指导价格是多少?”
Team 和 Enterprise 用户可能需要先由所有者添加连接器。有关账户设置流程,请参阅 Claude 的自定义连接器指南。
ChatGPT 设置
- 在 ChatGPT 网页版中,打开 Plugins,选择 +,然后选择 Add custom MCP server。
- 将其命名为 RuneScape Wiki MCP,输入上方托管端点,并选择 No authentication。
- 查看连接警告,然后选择 Create as a plugin。
- 安装生成的个人插件。在聊天中输入 @,选择该插件,然后询问:“比较 Dragon bones 和 Frost dragon bones。”
自定义 MCP 访问取决于你的工作区权限和安全设置。如果该选项不可用,请参阅 OpenAI 的自定义 MCP 指南。
其他 MCP 客户端
对于支持远程 MCP 配置的客户端,请使用:
{
"mcpServers": {
"runescape-wiki": {
"url": "https://runescape-wiki-mcp.fly.dev/mcp"
}
}
}
对于需要本地 stdio 的客户端,请通过 npm 安装:
{
"mcpServers": {
"runescape-wiki": {
"command": "npx",
"args": ["-y", "runescape-wiki-mcp"]
}
}
}
本地 stdio,在运行 bun install 和 bun run build 后:
{
"mcpServers": {
"runescape-wiki": {
"command": "node",
"args": ["/path/to/runescape-wiki-mcp/dist/index.js"]
}
}
}
也列于:
- Glama 托管连接器
- MCPRush
- 服务卡片:
https://runescape-wiki-mcp.fly.dev/mcp/server-card - AI Catalog:
https://runescape-wiki-mcp.fly.dev/.well-known/ai-catalog.json - 官方 MCP Registry:
io.github.birdwell/runescape-wiki-mcp - npm:
runescape-wiki-mcp
通过 stdio 和 Streamable HTTP 支持 MCP 2026-07-28(无状态),同时仍兼容 2025 年前后的旧版客户端。
工具
lookup_item— 将物品名称解析为 Grand Exchange ID,并获取最新指导价格或 Weirdgloop 价格。只知道名称时,请从这里开始。get_item_details— 单项或批量查询 Jagex 目录记录和指导价格,并可选择补充已记录的交易和数值事实。get_price_series— 查询历史价格的明确观测值/统计视图;优先按 ID 发现。estimate_flip— 计算扣除税费后的翻转利润,并可选择按剩余配额和假定时长进行估算。默认价格会滞后于实时市场。browse_items— 按起始字母浏览一个 Grand Exchange 类别。这不是名称搜索。get_ge_info— 目录元数据:默认状态、使用view: "categories"查询 ID/名称,或使用view: "category_counts"和category查询各字母的计数。get_player_stats— 查询用户名对应的 RS3 hiscores。gameMode用于选择普通、铁人或硬核模式。404 表示该玩家未出现在相应榜单中;不会改用其他榜单。search_wiki— 搜索 RuneScape Wiki 标题和源链接,适用于未知页面标题的情况。get_wiki_page_content— 跟随重定向获取来源参考;仅当修订版本经过审核且内容哈希匹配时提供文本。get_wiki_entity_facts— 获取结构化的怪物战斗数据和任务元数据。list_wiki_category_members— 获取 Wiki 类别的直接成员,并按类别继续查询。get_wiki_drop_table— 获取已索引的掉落引用、数量、掷骰次数和列出的稀有度;不包含备注。get_player_quests— 获取完整的公开 RuneMetrics 日志,包含任务状态和 Jagex 资格信息;无需 Jev 密钥。recommend_next_activity— 使用账户上下文和 Wiki 证据进行可选的付费目标规划;需要使用下方的服务配置。
在本地试用 Jev 推荐工具
循环由 MCP 服务负责。调用方助手提供目标及其掌握的任何账号背景信息,然后向玩家解释结构化结果。服务内部不需要单独的 Agent 框架或文本生成模型。
在本地且已忽略的 .env.local 文件中设置这些内容。不要提交 API 密钥:
RUNESCAPE_RECOMMENDATIONS_ENABLED=true
TYPESAFE_API_KEY=your-typesafe-key
# Optional; defaults to jev-latest
TYPESAFE_MODEL=jev-latest
bun run build
node --env-file=.env.local dist/index.js
# Or use dist/http.js for a local HTTP MCP endpoint.
入口点不会自动加载 dotenv 文件。对于 MCP 客户端的 stdio 配置,请通过其服务 env 块传递相同的设置,或在 Node 参数中加入 --env-file=/absolute/path/to/.env.local。
recommend_next_activity 参数示例:
{
"goal": "Train Prayer toward bossing",
"context": {
"username": "YourName",
"gameMode": "normal",
"skills": { "Prayer": 50 },
"budgetGp": 2000000,
"sessionMinutes": 45,
"playStyle": "active",
"members": true,
"completedQuests": ["The Restless Ghost"],
"gear": [],
"notes": "Prefer methods that help unlock future combat upgrades."
}
}
只有 goal 是必填项。提供用户名时,公开的 hiscores 会补全缺失的技能等级;调用方提供的等级优先,并会返回其来源。对于任务目标,任务完成情况来自 RuneMetrics;除非另行提供,否则会员状态、装备和银行物品均为未知。对于其他目标,调用方提供的已完成列表仅记录已知的完成情况;未列出某项任务并不表示该任务尚未完成。
询问任务相关问题时,请提供用户名和自然语言目标:
{
"goal": "What is the best mining quest to do?",
"context": { "username": "YourName" }
}
服务会读取最新的公开 RuneMetrics 日志和任务相关的 wiki 页面,解析标题别名和任务歧义,并读取 wiki 的通用前置条件表。已完成的任务会被排除。每个未完成的任务都会连同完成奖励、单独列出的有条件任务后奖励、技能和任务前置条件、当前状态、资格条件及已知阻碍一并发送给 Jev。独立比较会以有限批次运行,随后进行最终比较,选出一个现在可以进行的任务和有用的受阻目标。规划器会获取最终候选任务的快速指南清单,并返回其起始地点、时长、物品、敌人和开篇流程步骤。已开始的任务会保留其状态;具体阶段必须查看玩家的游戏内日志。
任务目标最多使用 24 次 Jev 请求(包括路由请求),且同时最多有两次比较请求在进行中。单个请求正文序列化后不超过 40,000 个字符。questCoverage 会报告日志总数、元数据覆盖情况,以及实际评估的未完成任务的确切数量。缺失或设为私密的日志以及缺失的 wiki 信息都会明确报告。技能和前置条件检查以及 Jagex 资格条件会限制可选项;当前会员状态、物品栏、战斗准备情况、增益替代方案和其他杂项要求可能仍需检查。过时的调用方任务完成列表不会覆盖最新的官方日志。公开的 wiki 任务元数据会缓存六小时;玩家日志从不缓存。
制定技能训练计划时,可以使用“将采矿练到 70 级”这样的目标,或提供 goalType: "skill_training"、targetSkill: "Mining" 和 targetLevel: 70。提供用户名时,服务会读取 wiki 训练表和最新的公开任务完成情况,保留诸如购买精力和自行收集精力等不同的速率假设,并比较各个里程碑可用的方法。trainingPlan 包含下一种方法、指南摘录、来源估算、替代方案,以及可计算时的剩余 XP。缺少 XP 时,会使用明确标注的等级下限上界。Invention 的精英 XP 曲线不会使用标准公式计算。计划最多覆盖六个里程碑,并报告任何剩余范围。建议等级区间不会成为严格的资格上限。不受支持的指南布局会明确标出。
如需规划解锁进度,可使用类似“帮我解锁 Invention”的目标,或提供
goalType: "unlock_progression" 和 unlock: "Invention"。规划器会读取有来源依据的要求,按顺序遍历尚未完成的前置任务,并返回所有已知的缺失技能目标。它会选择一个下一步操作,并获取相应的训练或任务指南。初始目录涵盖 Invention、维基 PvM 解锁指南中的目标,以及账号任务目录中列出的任务奖励。宽泛的比较最多涵盖最接近的 16 个目标;这并非 RuneScape 所有解锁内容的目录。完成任务并不能证明已领取奖励,或已满足额外挑战或能力等级要求。
训练目标最多使用两次 Jev 请求;解锁目标最多使用三次,包括训练选择。设置 goalType: "activity" 可使用原有的通用活动搜索。其他活动目标最多使用三次 Jev 请求:规划目标路线、筛选维基搜索结果,然后通过一次批处理评估目标相关性、资格、预算和时长匹配度。服务最多执行两次维基搜索,评估最多六个候选项,并读取最多三个页面。页面摘录上限为 6,000 个字符。路线规划和非任务请求的截止时间为 55 秒。完整任务比较在路线规划后另有五分钟的截止时间,以便完成受限的批处理和目录读取。MCP 客户端应为任务请求预留更长的超时时间。所有路径均有单独的获取超时;调用方输入的序列化 JSON 总长度上限为 20,000 个字符,并会在付费调用前检查。必要时会进一步缩短摘录,以确保完整的 Jev 请求不超过 40,000 个序列化字符;返回的来源会反映这些摘录。不会自动重试付费请求。返回的令牌用量可用于衡量实际用量;此原型不保证具体的美元成本。
结果包含 recommended、needs_context、no_match 或 goal_met,以及受证据支持时给出的建议、替代方案、维基摘录和链接、缺失的上下文、警告、Jev 对各维度的回答和令牌用量。建议是维基活动或指南,并非详尽的优化进度计划。对于通用活动建议,要求是基于摘录的模型评估,未经验证;requirementsVerified 为 false。任务建议会通过 requirementChecks、blockers 和 unknowns 报告确定性检查及其剩余限制。训练和解锁计划会返回 trainingCoverage 和 unlockCoverage;速率和利润数据是来源中的估算,并非当前价格或个人表现预测。它不会编造成本或时长。助手应说明任何条件,并询问相关的缺失信息。
目标、提供的账号上下文和检索到的证据会发送给 TypeSafe 进行评估。建议模块仅在处理请求期间保留账号数据和决策。它会缓存通用维基摘录五分钟,最多缓存 64 个页面;并缓存公开的训练/解锁指南六小时,最多缓存 16 个页面。 它不会缓存目标搜索,也不会更改玩家账号。禁用建议功能时,其他工具仍可正常使用。首次试用时请在本地使用或在访问控制之后使用;在公共服务上启用此工具,会允许调用方消耗运营者的付费 Jev 配额。
提示词
check_item_price—itemNamecompare_ge_items—items(逗号分隔的名称)estimate_item_flip—itemName,可选的quantityplayer_overview—username
典型的 Agent 工作流
lookup_item { query: "abyssal whip" }
→ id 4151, price …
get_item_details { itemId: 4151 }
get_price_series { itemId: 4151, view: "statistics", days: 30 }
search_wiki { query: "abyssal whip special attack" }
可选的历史记录范围使用 UTC 日历日期,例如 get_price_series { "itemId": 4151, "from": "2026-10-01", "to": "2026-10-07" }。范围会筛选可用样本;不会扩展 Jagex 的历史记录。
对于倒卖场景,buyLimitRemaining 表示你在当前时段内剩余的配额。结果会分别给出配额内的数量/利润和完整请求数量。fillTimeMinutes 是你为完整请求假设的往返时间,包括任何配额等待时间;据此可得出假设的每小时利润。这些输入是假设值,并非观测到的限额或预测的成交量。
使用 get_item_details 参数 itemIds(由 lookup_item 返回的 GE ID)批量获取目录元数据,或使用 get_wiki_page_content { "pages": ["Abyssal whip", "Grand Exchange"] } 批量获取 Wiki 页面引用。每次调用均接受 1–10 个条目,保留顺序,并为每一行返回 data 或 error,同时给出成功/失败计数。最多同时运行两个上游请求;若整个批次均失败,则工具会报错。上游返回 429 时会停止排队的请求,并保留 Retry-After 指引。单条物品/页面调用会保留现有的响应格式。Wiki 审查会分别应用于每个页面。
get_ge_info 会报告目录配置 RuneDay、其推导出的 UTC 日期和时效、检索时间以及规范类别数量。这些信息描述的是目录配置,而非物品价格的新鲜度;priceFreshness 为 not_reported。RuneDate 转换使用文档中说明的 UTC 纪元。
资源
| URI | 内容 |
|---|---|
runescape://ge/info | GE 数据库信息(非价格) |
runescape://ge/categories | 规范类别列表 |
数据来源
指导价格来自 Jagex。每日历史数据来自 Weirdgloop。两者都滞后于发布在 https://prices.runescape.wiki/api/v2/rs 的实时高价/低价数据源。此服务不会调用该数据源。
- Jagex GE:
https://secure.runescape.com/m=itemdb_rs/api - Jagex hiscores lite:
https://secure.runescape.com/m=hiscore/index_lite.ws - Weirdgloop RS 交易所:
https://api.weirdgloop.org/exchange/history/rs - RuneScape Wiki MediaWiki API:
https://runescape.wiki/api.php
所有请求均会发送 User-Agent:
RuneScape Wiki MCP Server - github.com/birdwell/runescape-wiki-mcp
署名与第三方内容
本内容使用 Jagex Limited 的知识产权创作,并遵循 Jagex 的粉丝内容政策。本内容不受 Jagex 认可,也与 Jagex 无关联。
请参阅 Jagex 的粉丝内容政策。这些署名信息不构成额外授权或合作关系。
价格历史和物品查询使用 Weirdgloop API。Wiki 文本由 RuneScape Wiki 贡献者编写,通常根据 CC BY-NC-SA 3.0 许可,具体以内容和修订版本特定的例外情况为准。
Wiki 搜索仅返回标题和链接,不会复制摘要。未经审核的页面只返回链接,并带有 contentStatus: "link_only"、text: null 和 attribution.license: null。文本结果和结构化结果均包含来源链接及贡献者历史链接。服务不会根据网站页脚或命名空间推断内容权限。
摘录必须在 src/wikiContentPolicy.ts 中进行针对具体内容的审核:记录准确的标题和修订版本、API 未经修剪的纯文本摘录的 SHA-256、实际许可证、版权声明、审核者、日期和支持审核的备注。默认情况下,不批准任何实时页面。即使页面已获批准,如果修订版本、命名空间或内容哈希发生变化,也会回退为仅提供链接。请审核整个摘录,检查是否包含导入材料或单独许可的材料,并保留其声明。摘要可验证审核过的字节,但不能确立法律许可。
经审核的许可证要求非商业使用或相同方式共享时,必须遵守相应条件。图片和其他媒体各有其条款。重新分发 Wiki 内容时,请保留署名和适用的许可证;下游摘要和改编内容也必须遵守这些条款。
MIT 许可证仅涵盖本项目的原创软件,不涵盖第三方文章文本、游戏数据、艺术作品或商标。仅有署名并不能解决尚待确认的 API、商业使用或品牌授权问题。
游戏名称用于标明工具所涉及的主题,并不表示获得赞助。可公开访问的 API、npm 包或目录列表均不代表获得提供方批准。请勿宣称本项目已获官方批准、不会导致封禁,或已获准用于所有商业用途或 AI 用途。请参阅来源审核和未解决的授权问题,了解相关证据和仍待确认的问题。
开发
- Node.js 20+
- bun
bun install
bun run build
bun run build:server-card # refresh local Smithery tool metadata after schema changes
bun run start # stdio MCP server
bun run test # unit + protocol compliance
bun run inspector # MCP Inspector
项目布局
src/
├── index.ts # stdio entry (serveStdio)
├── smithery.ts # Smithery HTTP factory
├── server.ts # createServer() + handlers
├── itemResolve.ts # name → ID resolution
├── categories.ts # GE category table
├── tools/ # MCP tools
└── resources.ts # MCP resources
备注
- 仅支持 RS3,不支持 OSRS(ID 和端点不同)。
- 指导价格和 Weirdgloop 历史数据会滞后于实时市场。有自己的买入价和卖出价时,请将它们传给
estimate_flip。 - 支持普通、铁人和硬核
index_lite端点。若所选排行榜上没有某位玩家,将返回 404 工具错误,不会回退到其他排行榜。 - 修改工具后,Smithery 托管方应重新构建服务卡片,使已发布的架构与此 README 一致。
许可证
原创软件:MIT。第三方内容保留其自身的许可证和权利;请参阅署名与第三方内容。本项目为非官方项目,与 Jagex 或 RuneScape Wiki 无关联。
原始历史数据:get_price_series 默认使用 Jagex 的每日/平均地图。将 source: "weirdgloop" 设为 Weirdgloop,可获取按时间顺序排列的每日 samples,其中包含 Unix 毫秒时间戳、价格以及可用的交易量。from/to 的范围上下限均包含在内,且采用 UTC,适用于任一提供方。使用 view: "statistics" 可获取计算得出的统计数据。
Wiki 搜索默认搜索文章。prefix:Category:Weapons 等查询前缀可选择其他 Wiki 命名空间。搜索仅返回引用;页面文本仍受现有的准确修订版本/内容审核政策约束。
目录记录包含 item.wikiUrl,这是官方 Wiki 的物品 ID 查询链接,会重定向至对应文章。此功能不会获取或复制文章文本。
已报告的交易和数值物品事实
get_item_details { "itemId": 4151, "includeLiveData": true } 会添加 item.liveTrades(最近报告的即时买入/高价和即时卖出/低价交易)以及 item.wikiFacts(已公布的购买限额、炼金价值和基础价值)。该标志也适用于 itemIds 批量请求。默认的 Jagex 指导价格字段保持不变。
此功能使用 RS3 API v2,而非 OSRS API 或已弃用的 RS3 v1 接口。交易时间戳为 Unix 秒。缺失的交易方向仍为 null;已记录的交易不是订单簿,也不保证是可执行报价。已公布的购买限额不会透露玩家剩余的购买额度。
公开交易快照缓存 30 秒,共享数值映射在每个服务进程中缓存 10 分钟;并发请求会合并处理,缓存的物品快照最多为 512 个。命中缓存时,fetchedAt 记录的是最初的获取时间。仅公开数值映射事实;映射中的检查文本、名称和媒体均会丢弃。Wiki 文章文本仍须遵循现有的逐修订版本/内容审核流程。
结构化怪物和任务事实
get_wiki_entity_facts { "page": "Abyssal demon", "kind": "monster" } 会返回已索引的数值战斗属性。kind: "quest" 会返回任务 ID、会员资格、受控难度/类型标签以及标准化发布日期。使用 search_wiki 查找标题。查询前会解析重定向;limit(1–10,默认值为 5)限制变体数量,truncated 表示还有其他已索引行。页面与类型不匹配时会报错。实体 ID 不是 GE 物品 ID。
此工具查询固定且有界的数据集,标题值保留在数据字面量中。它不会获取文章正文、图片或叙述性摘要。返回的引用用于标识页面/变体;归属链接用于标明来源,不会据此推断文章内容的许可协议。现有的精确修订版本/哈希策略仍适用于 get_wiki_page_content 文本。
发现名称和旧版调用
发现功能会将当前记录和候选对比归入 get_item_details,将按日期记录的观察值和统计信息归入 get_price_series。对 get_item_price、get_item_graph、compare_item_prices、compare_items 和 summarize_price_history 的现有调用仍会被接受,且参数和结果保持不变。别名不会在 14 个工具的发现列表中重复列出。
使用工具名称允许列表的客户端或网关可能需要启用新的发现名称。连接器 ID 和托管端点保持不变。不会移除任何旧版调用名称。
Wiki 分类和已索引掉落信息
list_wiki_category_members { "category": "Category:Weapons", "limit": 20 } 会返回直接成员的标题/ID/命名空间链接。使用相同分类传入其不透明的 nextCursor 可继续获取结果。此操作不会递归展开子分类,也不会获取文章正文/图片。空分类和不存在的分类都可能返回空集合;并发进行的 Wiki 编辑可能会改变页面边界。
get_wiki_drop_table { "page": "Abyssal demon", "limit": 20 } 会返回已索引的物品引用、数量范围、掉落次数,以及列出的概率或受控稀有度标签。未知事实保持为 null。使用 nextOffset 继续获取;可选的 variant 必须是该文章中的精确 sourceReference。物品引用不是 GE ID:请使用 lookup_item 进行解析。
掉落事实来自 RS3 dropsline 结构化索引。编辑备注和替代概率注释会被丢弃;hasOmittedAnnotations 用于标记这些内容是否存在。列出的概率描述的是各个独立行,并非无条件的综合战利品模型。请通过 sourceUrl 查看条件、嵌套表格和来源上下文。针对文章文本的精确修订版本/哈希审核门槛保持不变。
目录元数据视图
get_ge_info {} 保留原始配置状态响应。使用 { "view": "categories" } 列出 GE ID/名称,或使用 { "view": "category_counts", "category": 24 } 在调用 browse_items 前选择非空的起始字母。类别 ID 标识的是分组,而非物品;其条目数不代表可用库存。每种视图都会返回对应的现有结果结构。
旧版 get_all_categories {} 和 get_category_info { "category": 24 } 调用仍受支持,结果不变,定价兼容调用也一样。这两个目录辅助工具不再在发现列表中重复列出。所有现有调用名称仍受支持;已发布的工具列表包含 14 个工具。
Wiki 属性发现使用现有的分类查询,例如 search_wiki { "query": "incategory:\"Novice quests\"" }。若要遍历类别子树,请对返回的命名空间 14 成员标题再次调用 list_wiki_category_members;每个类别的游标应分别保留。
明确的历史视图与首选 ID 输入
新的工具发现将 lookup_item 用作名称解析步骤。将其选定的 GE ID 传给记录、历史、比较和翻转工具。旧版名称选择器(包括 compare_items/compare_item_prices 的名称数组)仍受服务端支持,结果不变,但不会在首选架构中重复列出。
get_price_series { "itemId": 4151 } 保留原始观测响应。view: "observations" 支持 Jagex(默认)或 Weirdgloop,以及 UTC from/to 时间界限。view: "statistics" 使用 Weirdgloop,可选 days(默认统计最近 30 个可用样本);该视图不接受 Jagex 和日历日期界限。每次调用只能使用一种模式。旧版 summarize_price_history 调用仍受支持,返回结果与统计视图完全相同。
严格的网关或客户端若依据最新工具发现进行验证,必须使用首选的基于 ID 的架构和历史视图。旧版名称和选择器仍可供较早的客户端在服务端调用;但这不会绕过网关自身的架构或允许列表策略。
当前数据视图
get_item_details { "itemId": 4151 } 保留原始目录记录响应。使用 view: "records" 获取单个/批量 Jagex 记录,以及可选的已记录交易补充信息。使用 { "view": "comparison", "itemIds": [4151,536] } 获取精简的 Weirdgloop 每日快照;此视图不接受 itemId 和实时补充信息。旧版 compare_item_prices 和 compare_items 调用仍受支持,结果不变,包括其旧版名称数组选择器。它们不再在包含 14 个工具的发现列表中重复列出。
受保护的规划器 Beta 版
支持账户信息的规划器可作为仅限邀请的 Beta 版运行,并提供身份验证和持久化的 Jev 消费限额。请参阅测试版设置与限额。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。