原型 · 预览版:收录官方注册中心里的全部服务器,每 30 分钟同步一次。使用 Google 登录即可撰写评价。原型 · 每 30 分钟更新
PopNx MCP为使用 AI 的人准备的 MCP 服务器 · 用大白话讲清楚

RuneScape Wiki

作者:birdwell版本 1.2.1i★ 2i电脑或云端官方网站 ↗
注册名称io.github.birdwell/runescape-wiki-mcp

安装方法

What it does

RS3 Grand Exchange prices, item lookup, player hiscores, and RuneScape Wiki content

  • Connects 电脑或云端
  • Account or key No key needed
  • Category 文档、表格与办公

可搭配使用

教 AI 做这类工作的 Skill,可与本项一起使用

MinerU

Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.

作者:opendatalab★ 83,9191 个 skill

Skill · 操作手册未注明许可证

watermarks-remover

A privacy-first app that strips AI watermarks from content you own.

作者:guillaumemeyer★ 27,7231 个 skill

Skill · 操作手册

obsidian-skills

Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.

作者:kepano★ 53,104 (whole repo)5 个 skill

Skill · 操作手册

为什么排在这里

列表按使用分(满分 100)排序,由以下部分组成

热度6/80GitHub 星标或每周下载量:较大的计 60,较小的计 20
新鲜度12/1230 天内有发布或代码更新得满分
仍在响应8/8上次检查时云端端点有响应
使用分26/100

质量: 基础检查通过 5/5 项(仅展示,不用于排序) · 上升势头: 暂无数据 (只用于“上升中”标签)

安装

选择你使用的 AI 应用,然后复制设置。

用一句话让 AI 帮你安装

请帮我安装 RuneScape Wiki。按照 https://mcp.popnx.com/i/birdwell-runescape-wiki-mcp.md 操作,先把命令给我看,等我同意后再运行。

粘贴到能在你电脑上工作的 AI(如 Claude Code、Cursor)。它会读取我们的步骤,先给你看命令,等你同意。无需密钥,无需注册。 · 查看 AI 会读取的全文

通过 5/5 项检查 · 你的提问会经过开发者的服务器(runescape-wiki-mcp.fly.dev) · ✓ 命令已检查 2026年11月13日

第一步:你用哪个 AI?

选择你用的应用,步骤会显示在下方。

可连接 Claude · 约 2 分钟

不需要密钥,不用安装程序 · 在 claude.ai 或桌面应用设置一次,即可在聊天中使用 · 免费账户可添加 1 个 · Team/Enterprise 方案由所有者(Owner)添加

  1. 打开 Claude 的 Connectors 页面

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. 点击“Add” → “Custom” → “Web”,填写这 2 项

    把这里的内容复制到 Claude 中同名的输入框,然后点击 Continue

    Name · 名称RuneScape Wiki
    Remote MCP server URL · 地址https://runescape-wiki-mcp.fly.dev/mcp

    在 Claude 检测到的登录设置页点击 Continue · Authentication 按作者说明选择(Sign in now、Sign in when needed 或 No sign in),然后点击 Add

  3. 在聊天中开启

    +ConnectorsRuneScape Wiki

  4. 试一试

    用 RuneScape Wiki 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 Claude 说正在使用 RuneScape Wiki,或回答中出现 RuneScape Wiki 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同

能否连接 ChatGPT 取决于方案

完整 MCP:网页版 ChatGPT Business、Enterprise 或 Edu · Pro:以读取/获取权限连接,修改数据的工具可能用不了 · Plus:官方文档尚未确认,如果在插件页看到添加自定义 MCP 的选项可以试试 · 仅限网页

  1. 在网页版 ChatGPT 打开添加 MCP 的页面

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. 填写名称和地址

    输入名称,在 Connection 下粘贴地址,勾选风险提示,然后点击 Create as a plugin

    Name · 名称RuneScape Wiki
    Connection · 地址https://runescape-wiki-mcp.fly.dev/mcp
  3. 在聊天中选择 RuneScape Wiki

    开启新聊天,输入前先从插件列表中选择 RuneScape Wiki

  4. 试一试

    用 RuneScape Wiki 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 ChatGPT 说正在使用 RuneScape Wiki,或回答中出现 RuneScape Wiki 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 OpenAI 帮助页面核实 · 你的界面可能因版本略有不同

可连接 Claude Code · 约 2 分钟

不需要密钥,不用安装程序

  1. 打开终端

    Mac:按 Command+空格,输入 Terminal · Windows:打开 PowerShell

  2. 粘贴这条命令并按 Enter

    claude mcp add --transport http --scope user runescape-wiki https://runescape-wiki-mcp.fly.dev/mcp
  3. 在 Claude Code 中输入 /mcp

    应能看到 RuneScape Wiki 在列表中并显示已连接

  4. 试一试

    用 RuneScape Wiki 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 Claude Code 说正在使用 RuneScape Wiki,或回答中出现 RuneScape Wiki 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同

可连接 Cursor · 约 2 分钟

不需要密钥,不用安装程序

  1. 点击这个按钮打开 Cursor

    在 Cursor 中打开

    Cursor 会请你确认安装,点击 Install

  2. 在 Cursor 中以 Agent 模式打开 AI 聊天

  3. 试一试

    用 RuneScape Wiki 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 Cursor 说正在使用 RuneScape Wiki,或回答中出现 RuneScape Wiki 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 Cursor 帮助页面核实 · 你的界面可能因版本略有不同

可连接 VS Code · 约 2 分钟

不需要密钥,不用安装程序

  1. 点击这个按钮打开 VS Code

    在 VS Code 中打开

    VS Code 会请你确认安装,点击 Install

  2. 在 VS Code 中以 Agent 模式打开 AI 聊天

  3. 试一试

    用 RuneScape Wiki 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 VS Code 说正在使用 RuneScape Wiki,或回答中出现 RuneScape Wiki 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 VS Code 帮助页面核实 · 你的界面可能因版本略有不同

其他支持 MCP 的应用(如 Windsurf、Zed、Gemini CLI)添加方式各不相同,请在应用列表中查看

查看所有支持 MCP 的应用 →

通过网页连接的应用使用的地址

地址https://runescape-wiki-mcp.fly.dev/mcp

JSON 设置在下方“开发者专用”中

卡住了?问问正在用 RuneScape Wiki 的人💬 讨论 →
开发者专用:终端命令和 JSON 设置

通过网页连接

Claude Code

claude mcp add --transport http --scope user runescape-wiki https://runescape-wiki-mcp.fly.dev/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "runescape-wiki": {
      "url": "https://runescape-wiki-mcp.fly.dev/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "runescape-wiki": {
      "type": "http",
      "url": "https://runescape-wiki-mcp.fly.dev/mcp"
    }
  }
}

安装在电脑上

Claude Code

claude mcp add --scope user runescape-wiki -- npx -y runescape-wiki-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "runescape-wiki": {
      "command": "npx",
      "args": [
        "-y",
        "runescape-wiki-mcp"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "runescape-wiki": {
      "command": "npx",
      "args": [
        "-y",
        "runescape-wiki-mcp"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "runescape-wiki": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "runescape-wiki-mcp"
      ]
    }
  }
}

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。

一览

每周下载量i
48/周
连接方式
电脑或云端
传输方式
stdio, streamable-http
最新版本i
1.2.1
发布到注册中心i
2026年10月16日
代码最后更新i
2026年11月16日
最近检查
2026年11月18日
作者
birdwell
软件包
npm: runescape-wiki-mcp
注册状态
活跃

哪些应用可以使用它

依据这个服务器的连接方式和各应用自己的文档,检查于 2026年11月10日。

通过互联网连接,适用于

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

在你的电脑上运行,适用于

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

全部应用及其优缺点 →

它能做什么

工具名称和描述与服务器在 2026年11月18日 报告的完全一致。这些内容由作者撰写,不是我们写的;我们以纯文本形式显示。

  • lookup_item

    Resolve tradeable RS3 names to GE IDs. Use search_wiki for quests, NPCs or guides; non-GE items cannot match here. - query="Abyssal whip" tries an exact match; "abyssal" discovers alternatives. An exact match ends the search regardless of limit. - limit also bounds Wiki candidate

  • get_price_series

    Read dated RS3 price history for one known GE item. Resolve names with lookup_item; use get_item_details for current records or candidate comparisons. - itemId=4151 means Abyssal whip, not a quantity. For observations, choose Jagex for provider averages over roughly 180 days or W

  • get_item_details

    Read current RS3 catalogue records or compare candidate snapshots. Resolve names with lookup_item; use get_price_series for dated history and estimate_flip for profit calculations. - records reads Jagex identity, examine/type/membership, icon URLs and guide prices. itemId=4151 me

  • get_ge_info

    Read RS3 GE catalogue metadata. Do not use this for item prices: use get_item_details. For entries use browse_items; for Wiki categories use list_wiki_category_members. - view=status reports configuration date/age, not price freshness. - view=categories lists all 44 built-in IDs;

  • browse_items

    List GE items within one numeric category. Use list_wiki_category_members for Wiki Category: titles, lookup_item for names, or get_item_details for individual records. - Discover IDs with get_ge_info view=categories and nonempty letters with view=category_counts. IDs 0 and 42 bot

  • estimate_flip

    Calculate RS3 resale-profit scenarios after seller tax. ESTIMATE ONLY; never places an order. Use get_item_details for current records/comparisons or lookup_item to resolve names. - itemId=4151 means Abyssal whip, not a quantity. quantity scales total investment, tax and profit w

  • get_player_quests

    Read a public RS3 character's complete RuneMetrics quest journal. Use recommend_next_activity for paid advice, get_player_stats for levels, or get_wiki_entity_facts with kind=quest for one quest's metadata. - username is the character's display name, not a Jagex login, account ID

  • get_player_stats

    Read an RS3 player's published hiscores ranks, levels and experience, including Overall. Use search_wiki for training guides rather than player data. - username is the literal in-game display name, including spaces; the server URL-encodes it. gameMode chooses a separate leaderboa

  • search_wiki

    Find RS3 Wiki sources for items, NPCs/monsters, quests and guides. Use get_wiki_page_content for reviewed text/page references, lookup_item for GE identities or get_item_details for catalogue records. query accepts raw Wiki syntax; the server URL-encodes it. "Abyssal demon" "drop

  • get_wiki_page_content

    Get reviewed Wiki article text, or a source reference when text is unavailable. Use search_wiki for titles; get_item_details for prices. - page takes one unencoded title; pages takes 1-10, e.g. ["Abyssal whip"]. URLs, #fragments and |separators reject the call before fetching. -

  • recommend_next_activity

    Plan the next RS3 activity, training milestone or unlock prerequisite. Use get_player_quests for progress, get_player_stats for levels, get_wiki_entity_facts for one quest's facts, or search_wiki for references. - Routing: unlock overrides goalType, otherwise goalType overrides i

  • get_wiki_entity_facts

    Read RS3 monster combat stats or quest metadata. Use search_wiki for titles, get_wiki_page_content for reviewed text/links, or get_item_details for GE records. - page is a literal main-article title with spaces; the server URL-encodes it. URLs, #variants, |separators and Category

  • list_wiki_category_members

    List direct articles, subcategories and files in an RS3 Wiki category. Use search_wiki to discover category titles; get_ge_info (view=categories) lists GE groups instead. category is a literal Category: title, not a GE number. limit bounds this page of members, not recursion dept

  • get_wiki_drop_table

    Read indexed RS3 drop items, quantities and listed rarities. Use get_wiki_entity_facts for combat stats or lookup_item for GE identities. - page resolves redirects; put #variant only in variant. A supplied variant must match a returned sourceReference; omission includes all varia

基础检查i

我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月19日

  • ✓ 通过

    作者与仓库一致

    注册名称已通过 GitHub 账户 birdwell 验证,该账户拥有此仓库

  • ✓ 通过

    仍在维护

    代码最后更新于3天前

  • ✓ 通过

    有许可证

    使用 MIT

  • ✓ 通过

    端点有响应

    在 437 毫秒内响应(HTTP 200)

  • – 不适用

    使用 OAuth 登录

    无需登录

  • ✓ 通过

    工具描述中没有隐藏指令

    已读取 14 个工具描述,未发现针对 AI 的隐藏指令

云端地址最近 4 次检查中有 4 次响应 · 最近一次 437 ms · 检查于 2026年11月18日

已公开的漏洞(OSV.dev)

OSV.dev 中没有 runescape-wiki-mcp@1.2.0 的记录

只检查这个版本的包本身,不包括所有依赖 · 检查于 2026年11月15日

我们检查什么 → · JSON

作者:申请重新检查或报告信息错误
给作者:在 README 中加徽章

如果你是作者,可把这段代码贴到 README。徽章会链接回本页。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/birdwell-runescape-wiki-mcp.svg)](https://mcp.popnx.com/en/servers/birdwell-runescape-wiki-mcp)

讨论

提问、分享技巧或报告无法使用。按“有帮助”数量排序。

还没有帖子,欢迎第一个提问或分享。

此处内容由用户撰写,不代表 PopNx 团队。

登录后发帖

用户评价

还没有评价

登录后写评价

与“文档、表格与办公”中的其他服务器比较i

  • 星标数多于此分类中其他 4110 个服务器的 86%
  • 发布到注册中心的时间比此分类中其他 4110 个服务器的 48% 更新
  • 基础检查结果等于或优于此分类中其他 4110 个服务器的 99%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。

常见问题

RuneScape Wiki 安全吗?

它在 5 项适用的基础检查中通过了 5 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。

它需要哪些密钥或代码?

注册中心没有列出必需的密钥,不过有些服务器会在首次使用时要求你登录。

它在我的电脑上运行还是在云端?

两种方式都可以:安装在你的电脑上,或者连接云端版本。

它还在维护吗?

GitHub 仓库最后更新于3天前,最新版本(1.2.1)于34天前进入注册中心。

哪些应用可以使用它?

支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接,因此也能用于接受远程 MCP 的应用,例如网页版 ChatGPT(Business 及以上为完整 MCP;Pro 为只读)。

有什么可以替代它?

同一分类中有:Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server

功能相近的其他选择

同一分类、其他作者、命令已通过检查。官方的排在前面,再按星标排序。

如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

Puter MCP

Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more

作者:HeyPuter广泛使用★ 4.4万5个月前更新

在云端运行✓ 服务方 · puter.com

XcodeBuildMCP

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

作者:getsentry广泛使用↓ 13万/周 共用包的下载量★ 65854个月前更新

在你的电脑上运行✓ 服务方 · xcodebuildmcp.com

Vexa

Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.

作者:Vexa-ai广泛使用★ 29942个月前更新

在云端运行✓ 服务方 · vexa.ai

Anki MCP Server

MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.

作者:ankimcp正在增长↓ 1136/周★ 567上个月更新

在你的电脑上运行✓ 服务方 · ankimcp.ai
与相似项目对比
本项
RuneScape Wiki
Puter MCPXcodeBuildMCPVexaAtlassian Rovo MCP ServerAnki MCP Server
运行位置云端或安装在电脑上都可以在云端运行,无需安装需要安装在电脑上在云端运行,无需安装在云端运行,无需安装需要安装在电脑上
需要密钥否否否是否否
可在 Claude 中按 + 添加否否否否是否
基础检查5/54/43/32/44/43/3
许可证MITAGPL-3.0MITApache-2.0Apache-2.0MIT
价格登记中未列出费用登记中未列出费用登记中未列出费用登记中未列出费用登记中未列出费用登记中未列出费用

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

RuneScape 3 MCP Server

Ask what it's worth, whether the flip clears tax, and what to train next.

Connect Claude, ChatGPT, Cursor, and other assistants to RuneScape 3 Grand Exchange guide prices, 7–90 day history, flip math after the 2% tax, public RS3 hiscores, and wiki pages. RS3 only. Unofficial, and not affiliated with Jagex or the RuneScape Wiki.

An independent Birdwell Labs project. No Jagex or Weird Gloop approval is claimed. Support and rights concerns · Permissions and source review.

get_item_details returns Jagex guide prices by default. Guide prices lag the in-game market. Set includeLiveData: true in the records view to add the latest reported instant-buy and instant-sell trades alongside the guide prices.

Questions to ask

  • What's the guide price of a Noxious scythe, and how did it move over 30 days?
  • Compare a Noxious scythe, a Dragon rider lance, and an Abyssal whip.
  • Estimate the profit from flipping 100 Dragon rider lances after tax.
  • Look up my stats and tell me the weakest skill to train. Normal mode.
  • Find the RuneScape Wiki source link for the Abyssal whip special attack.

The server answers questions about items you name. It does not rank the whole Grand Exchange.

Price questions use lookup_item, get_item_details current-data views, get_price_series history views, and estimate_flip. Stats questions use get_player_stats on the selected normal, ironman or hardcore board; the assistant turns those levels into a training suggestion. Wiki questions use search_wiki, then get_wiki_page_content.

Wiki pages return source links by default. Article text is available only for reviewed revisions; the server does not supply an article summary when text is withheld.

Access and data handling

This server reads public APIs and performs calculations. It does not connect to the game client, control characters, place trades or ask for your Jagex password, session cookies or bank PIN. A player-name lookup sends the supplied name to Jagex's public hiscores endpoint.

Your assistant receives tool results and may use them to generate an answer. Its own privacy, retention and model-training settings apply separately; this project cannot promise how an AI provider handles those results. Check linked sources before acting on generated advice.

See the privacy policy before using the hosted service. Optional diagnostics may receive request context, and enabling DEBUG can print tool arguments and returned data. Do not submit secrets or information you do not want processed by the service and your AI provider.

Connect

Hosted endpoint: https://runescape-wiki-mcp.fly.dev/mcp

Privacy policy describes the tool-request data, diagnostics and service providers involved.

No server account, API key, game login or local installation is needed. Use Streamable HTTP with no authentication.

Claude setup
  1. Open Customize → Connectors, then + Add → Add custom connector.
  2. Name it RuneScape Wiki MCP and enter the hosted endpoint above.
  3. Choose No sign in when asked about authentication, then finish adding the connector.
  4. In a chat, enable it through + → Connectors and ask: “What is the RS3 guide price of an Abyssal whip?”

Team and Enterprise users may need an owner to add the connector first. See Claude's custom connector guide for your account's setup flow.

ChatGPT setup
  1. On ChatGPT web, open Plugins, select +, then Add custom MCP server.
  2. Name it RuneScape Wiki MCP, enter the hosted endpoint above, and select No authentication.
  3. Review the connection warning, then choose Create as a plugin.
  4. Install the resulting personal plugin. In a chat, type @, select it, and ask: “Compare Dragon bones and Frost dragon bones.”

Custom MCP access depends on your workspace permissions and security settings. See OpenAI's custom MCP guide if the option is unavailable.

Other MCP clients

For clients that accept remote MCP configuration, use:

{

"mcpServers": { "runescape-wiki": { "url": "https://runescape-wiki-mcp.fly.dev/mcp" } } }

For clients that require local stdio, install through npm:

{

"mcpServers": { "runescape-wiki": { "command": "npx", "args": ["-y", "runescape-wiki-mcp"] } } }

Local stdio, after bun install and bun run build:

{

"mcpServers": { "runescape-wiki": { "command": "node", "args": ["/path/to/runescape-wiki-mcp/dist/index.js"] } } }

Also listed on:

Speaks MCP 2026-07-28 (stateless) via stdio and Streamable HTTP, with legacy 2025-era clients still supported.

Tools

  • lookup_item — Resolve an item name to a Grand Exchange ID and the latest guide or Weirdgloop price. Start here when you only know the name.
  • get_item_details — Single/batch Jagex catalogue records and guide prices. In the records view, includeLiveData: true adds reported trades and numeric Wiki facts.
  • get_price_series — Explicit observations/statistics views over historical prices; ID-based preferred discovery.
  • estimate_flip — Tax-adjusted flip profit, with optional remaining-quota and assumed-duration scenarios. Default prices lag the live market.
  • browse_items — Browse one Grand Exchange category by starting letter. This is not a name search.
  • get_ge_info — Catalogue metadata: default status, view: "categories" for IDs/names, or view: "category_counts" with category for letter counts.
  • get_player_stats — RS3 hiscores for a username. gameMode selects normal, ironman or hardcore. A 404 means the player was not found on that board; no other board is substituted.
  • search_wiki — Search RuneScape Wiki titles and source links when the page title is unknown.
  • get_wiki_page_content — Source reference following redirects; text only for a reviewed revision and matching content hash.
  • get_wiki_entity_facts — Structured monster combat statistics and quest metadata.
  • list_wiki_category_members — Direct Wiki category members with category-bound continuation.
  • get_wiki_drop_table — Indexed drop references, quantities, rolls and listed rarities; notes are excluded.
  • get_player_quests — Complete public RuneMetrics journal with quest statuses and Jagex eligibility; no Jev key needed.

recommend_next_activity adds paid goal-based planning using account context and Wiki evidence. It appears only on servers with RUNESCAPE_RECOMMENDATIONS_ENABLED=true and a nonblank TYPESAFE_API_KEY. With the planner disabled, the catalog has 13 tools.

Try the Jev recommendation tool locally

The MCP server owns the loop. The calling assistant supplies a goal and whatever account context it knows, then explains the structured result to the player. No separate agent framework or text-generation model is needed inside the server.

Set these in a local, ignored .env.local file. Do not commit the API key:

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.

The entry point does not automatically load dotenv files. For an MCP client's stdio configuration, pass the same settings through its server env block or include --env-file=/absolute/path/to/.env.local in the Node arguments.

Example recommend_next_activity arguments:

{

"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." } }

Only goal is required. Public hiscores fill missing skill levels when a username is supplied; caller-supplied levels take precedence and their provenance is returned. Quest completion comes from RuneMetrics for quest goals; membership, gear and bank contents remain unknown unless provided. For other goals, a caller-supplied completed list records known completions only; absence does not mean a quest is unfinished.

For a quest question, supply the username and natural-language goal:

{

"goal": "What is the best mining quest to do?", "context": { "username": "YourName" } }

The server reads the fresh public RuneMetrics journal and the wiki pages for its quests, resolves title aliases and quest disambiguation, and reads the wiki's shared prerequisite table. Completed quests are excluded. Every unfinished quest is sent to Jev with completion rewards, separate conditional post-quest rewards, skill and quest prerequisites, current status, eligibility, and known blockers. Independent comparisons run in bounded batches, then a final comparison picks a quest to do now and useful blocked targets. The planner fetches the finalists' quick-guide checklists and returns their starting location, length, items, enemies, and opening walkthrough steps. Started quests retain their status; the exact stage must be read from the player's in-game journal.

Quest goals use at most 24 Jev requests, including routing, with two comparison requests in flight at once. Individual request bodies stay below 40,000 serialized characters. questCoverage reports journal totals, metadata coverage and the exact number of unfinished quests evaluated. Missing/private journals and missing wiki facts are reported explicitly. Skill/prerequisite checks and Jagex eligibility constrain the choices; current membership, inventory, combat readiness, boost alternatives and miscellaneous requirements may still need checking. A stale caller-supplied completion list does not override the fresh official journal. Public wiki quest metadata is cached for six hours; player journals are never cached.

For a skill training plan, use a goal such as "Train Mining to 70", or supply goalType: "skill_training", targetSkill: "Mining" and targetLevel: 70. For

只显示了开头部分;其余内容请在仓库中阅读