OSRS MCP Server

OSRS MCP 服务

用于与 Old School RuneScape（OSRS）Wiki API 和数据文件交互的 MCP 服务。此服务提供用于搜索 OSRS Wiki 并通过 Model Context Protocol 访问游戏数据定义的工具。

工具

此服务实现了以下工具：

OSRS Wiki 方法

1. osrs_wiki_search - 在 OSRS Wiki 中搜索与搜索词匹配的页面
2. osrs_wiki_get_page_info - 获取 OSRS Wiki 特定页面的信息
3. osrs_wiki_parse_page - 获取 OSRS Wiki 特定页面解析后的 HTML 内容

游戏数据搜索方法

4. search_varptypes - 搜索 varptypes.txt 文件，查找存储玩家状态和进度的玩家变量（varps）
5. search_varbittypes - 搜索 varbittypes.txt 文件，查找存储 varps 中单个位的变量位（varbits）
6. search_iftypes - 搜索 iftypes.txt 文件，查找游戏 UI 中使用的界面定义
7. search_invtypes - 搜索 invtypes.txt 文件，查找游戏中的库存类型定义
8. search_loctypes - 搜索 loctypes.txt 文件，查找游戏世界中的位置／对象类型定义
9. search_npctypes - 搜索 npctypes.txt 文件，查找 NPC（非玩家角色）定义
10. search_objtypes - 搜索 objtypes.txt 文件，查找游戏中的对象／物品定义
11. search_rowtypes - 搜索 rowtypes.txt 文件，查找各种界面中使用的行定义
12. search_seqtypes - 搜索 seqtypes.txt 文件，查找动画序列定义
13. search_soundtypes - 搜索 soundtypes.txt 文件，查找游戏中的音效定义
14. search_spottypes - 搜索 spottypes.txt 文件，查找点动画（图形效果）定义
15. search_spritetypes - 搜索 spritetypes.txt 文件，查找界面中使用的精灵图像定义
16. search_tabletypes - 搜索 tabletypes.txt 文件，查找界面选项卡定义

通用数据文件方法

17. search_data_file - 搜索 data 目录中的任意文件，查找匹配的条目
18. get_file_details - 获取 data 目录中文件的详细信息
19. list_data_files - 列出 data 目录中可用的数据文件

大交易所价格

20. search_ge_items - 按名称搜索可在大交易所交易的物品。返回物品 ID、名称、购买限额和炼金价值
21. get_ge_latest - 根据物品 ID 获取指定物品在大交易所的最新最高价和最低价
22. get_ge_timeseries - 获取指定时间间隔（5m、1h、6h、24h）下物品的历史时间序列价格数据。最多返回 365 个数据点

玩家查询

23. lookup_player - 从官方 hiscores 查询 OSRS 玩家的数据（技能、Boss、线索卷轴和活动）

安装

通过 Smithery 安装

通过 Smithery 自动为 Claude Desktop 安装 mcp-osrs：

npx @smithery/cli@latest install @jayarrowz/mcp-osrs --client claude

前置条件

• Node.js（v16 或更高版本）
• npm 或 yarn

安装软件包

# Clone the repository
git clone https://github.com/jayarrowz/mcp-osrs.git
cd mcp-osrs

# Install dependencies
npm install

# Build the package
npm run build

在 Claude Desktop 中使用

将以下内容添加到 claude_desktop_config.json：

使用 npx

{
  "mcpServers": {
    "osrs": {
      "command": "npx",
      "args": ["-y", "@jayarrowz/mcp-osrs"]
    }
  }
}

直接使用 Node.js

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

将 /path/to/mcp-osrs 替换为仓库的实际路径。

示例

搜索 OSRS Wiki

// Search for information about the Abyssal whip
const result = await callTool("osrs_wiki_search", { 
  search: "Abyssal whip" 
});

获取页面信息

// Get information about a specific wiki page
const pageInfo = await callTool("osrs_wiki_get_page_info", { 
  titles: "Abyssal_whip" 
});

搜索游戏数据

// Search for items in the object definitions
const items = await callTool("search_objtypes", { 
  query: "dragon",
  page: 1,
  pageSize: 10
});

列出可用的数据文件

// Get a list of all data files
const files = await callTool("list_data_files", {});

搜索 Grand Exchange 物品

// Search for tradeable items by name
const items = await callTool("search_ge_items", { 
  query: "dragon scimitar",
  page: 1,
  pageSize: 10
});

获取最新 GE 价格

// Get the latest high/low prices for an item
const prices = await callTool("get_ge_latest", { 
  itemId: 2 // Cannonball
});

获取 GE 价格历史记录

// Get time-series price data for an item
const history = await callTool("get_ge_timeseries", { 
  itemId: 2,
  timestep: "1h"
});

查询玩家

// Look up an OSRS player's stats
const stats = await callTool("lookup_player", { 
  playerName: "Zezima"
});

开发

# Install dependencies
npm install

# Start the server in development mode
npm start

# Build the server
npm run build

许可证

此 MCP 服务采用 MIT 许可证。这意味着你可以自由使用、修改和分发本软件，但须遵守 MIT 许可证的条款和条件。详情请参阅项目仓库中的 LICENSE 文件。