mcp-server-runescape

mcp-server-runescape

这是一个 MCP 服务，提供用于查询 RuneScape (RS) 和 Old School RuneScape (OSRS) 数据的工具，包括物品价格、玩家排行榜等。

https://github.com/user-attachments/assets/7c141575-443b-4b76-8b33-6d48ec82fbe7

功能

MCP 服务提供了多种工具，可在游戏过程中使用准确来源的数据回答你的问题。

1. 物品详情 (get_item_details)

获取可交易物品的详细信息，包括：

• 大交易所中的当前价格
• 价格趋势（24 小时、30、90 和 180 天）
• 名称
• 类别
• 描述（检视文本）
• 图片
• 是否为会员物品
• ID

https://runescape.wiki/w/Application_programming_interface#detail

2. 物品价格历史 (get_item_price_history)

查询物品过去 180 天的价格历史，包括：

• 指定日期（时间戳）的价格
• 指定日期（时间戳）的平均价格

https://runescape.wiki/w/Application_programming_interface#Graph

3. 玩家排行榜 (get_player_hiscore)

获取任意玩家的技能和活动排名及经验值，包括：

• 玩家排名
• 技能等级
• 经验值
• 活动分数

https://runescape.wiki/w/Application_programming_interface#Hiscores_Lite_2

4. 排名榜单 (get_top_rankings)

查看指定技能或活动的前 50 名玩家，包括：

• 名称
• 分数（技能和活动均使用此项）
• 排名

https://runescape.wiki/w/Application_programming_interface#ranking

5. 玩家数量 (get_player_count)

获取 RuneScape 和 Old School RuneScape 当前在线的玩家数量，包括：

• 实时玩家人数

https://runescape.wiki/w/Application_programming_interface#player_count

6. 账号总数 (get_rsuser_total)

获取当前已创建、可访问任意形式 RuneScape 的账号数量。这包括在 FunOrb 或某个 RuneScape 版本中创建的账号，以及：

• 历史账号创建数据

https://runescape.wiki/w/Application_programming_interface#rsusertotal

注意

为确保一致性，我尽量只使用同时支持 RS 和 OSRS 数据的 API 端点。

示例用例

我们的目标是让你在查找资料时，能轻松地直接从来源获取更准确的数据。

使用此 MCP 服务时，你可以向 AI 提出以下示例问题：

物品详情

"What is the price of a dragon scimitar in the Grand Exchange?"
"Torva full helm price"
"Current price of a dragon pickaxe"
"How much percentage has the price of a dragon pickaxe changed in the past 30 days?"
"How much percentage has the price of a dragon pickaxe changed in the past 90 days?"
"How much percentage has the price of a dragon pickaxe changed in the past 180 days?"
"Give me the description of an armadyl godsword"
"Give me the icon of a dragon scimitar"
"What is the id of an abbyssal whip?"

物品价格历史

"Give me the price history of a dragon scimitar"
"Rune scimitar price on 1 april 2025?"

玩家排行榜

"What rank is Zezima?"
"What rank is Zezima on runescape?"
"How much experience does Lynx Titan have overall?"
"Iron Hyger ironman rank?"

排名榜单

"Top 10 players overall?"
"Give me the top 50 attack rankings"
"Number one agility on runescape?"
"Most zulrah kills?"
"Give me the top 5 jad rankings"

开始使用

Introduction to MCP servers

你可以在许多客户端中使用 MCP 服务，例如：

• Claude 桌面版
• Cursor

1. 在配置中添加 MCP 服务（NPM Package）

将以下代码片段粘贴到客户端使用的 MCP 配置中

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

你可以在以下位置找到配置文件（mac）：

• Claude 桌面版：

~/Library/Application Support/Claude/claude_desktop_config.json

• Cursor：

/Users/name/.cursor/mcp.json

2. 从源代码运行

需要 在系统中安装 Node.js

1. 克隆此代码库
2. 安装依赖项：

   yarn
   

   或

   npm install
   

3. 然后在 Claude 桌面版或 Cursor 中更新以下配置：

   {
     "mcpServers": {
       "mcp-server-runescape": {
         "command": "node",
         "args": ["/Users/path/to/mcp-server-runescape/src/server.js"]
       }
     }
   }
   

4. 可选：运行调试器/检查器

   yarn dev
   

   或

   npm run build
   

请务必：

• 将 /path/to/mcp-server-runescape 替换为实际的安装路径。

更新配置后，重启 Claude 桌面版或 Cursor，使更改生效。

个人偏好

你可以使用任意客户端；目前我个人更偏好 Cursor，并搭配 deepseek-v3.1，效果相当不错。

客户端列表

API 文档

有关此 MCP 服务使用的 Runescape API 端点的详细信息，请访问： RS/Wiki API

致谢

我利用周末的时间完成了这个项目，想借此进一步了解 MCP 服务。Runescape 是尝试 MCP 的绝佳主题。

• 特别感谢 rs/wiki 团队提供文档和 API。

如果这能在你爬取数据时帮到你，并且你愿意支持我，欢迎：