OSRS MCP 服务器

用于与《老学校 RuneScape》（OSRS）Wiki API 和数据文件交互的 MCP 服务器。此服务器通过模型上下文协议提供了搜索 OSRS Wiki 和访问游戏数据定义的工具。

工具

此服务器实现了以下工具：

OSRS Wiki 方法

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

游戏数据搜索方法

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

通用数据文件方法

1. search_data_file - 搜索数据目录中的任何文件以查找匹配项
2. get_file_details - 获取数据目录中文件的详细信息
3. list_data_files - 列出数据目录中可用的数据文件

安装

通过 Smithery 安装

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

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

先决条件

• Node.js (v16 或更高版本)
• npm 或 yarn

安装包

bash

克隆仓库

git clone https://github.com/jayarrowz/mcp-osrs.git
cd mcp-osrs

安装依赖

npm install

构建包

npm run build

与 Claude Desktop 一起使用

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

使用 npx

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

直接使用 Node.js

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

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

示例

搜索 OSRS Wiki

javascript
// 搜索关于 Abyssal whip 的信息
const result = await callTool("osrs_wiki_search", {
search: "Abyssal whip"
});

获取页面信息

javascript
// 获取特定 wiki 页面的信息
const pageInfo = await callTool("osrs_wiki_get_page_info", {
titles: "Abyssal_whip"
});### 搜索游戏数据
javascript
// 在对象定义中搜索项目
const items = await callTool("search_objtypes", {
query: "dragon",
page: 1,
pageSize: 10
});

列出可用的数据文件

javascript
// 获取所有数据文件的列表
const files = await callTool("list_data_files", {});

开发

bash

安装依赖

npm install

在开发模式下启动服务器

npm start

构建服务器

npm run build

许可证

此MCP服务器根据MIT许可证授权。这意味着您可以自由使用、修改和分发该软件，但需遵守MIT许可证的条款和条件。更多详情，请参阅项目仓库中的LICENSE文件。