【技术文档摘要】：

OSRS MCP 服务器

用于与旧版龙之时代（OSRS）维基API和数据文件交互的MCP服务器。此服务器提供了搜索OSRS维基并通过模型上下文协议访问游戏数据定义的工具。

<a href="https://glama.ai/mcp/servers/@JayArrowz/mcp-osrs"> <img width="380" height="200" src="https://gips1.baidu.com/it/u=4053864526,1162570808&fm=3081&app=3081&f=PNG?w=760&h=400" alt="OSRS Server MCP 服务器" /> </a>

工具

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

OSRS 维基方法

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

游戏数据搜索方法

4. search_varptypes - 搜索varptypes.txt文件中的玩家变量（varps），这些变量存储玩家状态和进度
5. search_varbittypes - 搜索varbittypes.txt文件中的变量位（varbits），这些变量位从varps中存储单个位
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目录下可用的数据文件

安装

通过 Smithery 安装

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

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

先决条件

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

安装包

# 克隆仓库
git clone https://github.com/jayarrowz/mcp-osrs.git
cd mcp-osrs

# 安装依赖
npm install

# 构建包
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 维基

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

获取页面信息

// 获取特定维基页面的信息
const pageInfo = await callTool("osrs_wiki_get_page_info", { 
  titles: "Abyssal_whip" 
});

搜索游戏数据

// 搜索对象定义中的物品
const items = await callTool("search_objtypes", { 
  query: "dragon",
  page: 1,
  pageSize: 10
});

列出可用数据文件

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

开发

# 安装依赖
npm install

# 在开发模式下启动服务器
npm start

# 构建服务器
npm run build

许可证

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