OSRS MCP Server

OSRS MCP Server

site icon
2025.04.23 1
JavaScript游戏数据服务Wiki API 交互娱乐功能
mcp-osrs 是一个用于与 Old School RuneScape (OSRS) Wiki API 和数据文件交互的 MCP 服务器。该服务器提供了搜索 OSRS Wiki 和通过 Model Context Protocol 访问游戏数据定义的工具。
View on GitHub

Overview

基本能力

产品定位

mcp-osrs 是一个专门为 Old School RuneScape (OSRS) 游戏设计的 MCP 服务器,主要用于与 OSRS Wiki API 和数据文件交互。

核心功能

  1. OSRS Wiki 方法
  2. osrs_wiki_search:搜索 OSRS Wiki 中匹配搜索词的页面
  3. osrs_wiki_get_page_info:获取特定 OSRS Wiki 页面的信息
  4. osrs_wiki_parse_page:获取特定 OSRS Wiki 页面的解析 HTML 内容

  5. 游戏数据搜索方法

  6. 提供多种搜索功能,包括 search_varptypessearch_varbittypessearch_iftypes 等,用于搜索游戏中的各种数据定义。

  7. 通用数据文件方法

  8. search_data_file:搜索数据目录中的任何文件以匹配条目
  9. get_file_details:获取数据目录中文件的详细信息
  10. list_data_files:列出数据目录中的可用数据文件

适用场景

  • 游戏开发者需要访问 OSRS Wiki 数据
  • 游戏数据分析师需要查询游戏内部数据定义
  • 游戏爱好者需要快速获取游戏相关信息

工具列表

  1. OSRS Wiki 工具:用于搜索和获取 OSRS Wiki 的页面信息。
  2. 游戏数据搜索工具:用于搜索游戏中的各种数据定义,如物品、NPC、动画等。
  3. 通用数据文件工具:用于搜索和列出数据目录中的文件。

常见问题解答

  • 如何安装?:可以通过 Smithery 自动安装,或者手动克隆仓库并安装依赖。
  • 需要哪些前置依赖?:Node.js (v16 或更高版本) 和 npm 或 yarn。

使用教程

使用依赖

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

安装教程

  1. 通过 Smithery 安装bash npx @smithery/cli@latest install @jayarrowz/mcp-osrs --client claude

  2. 手动安装bash git clone https://github.com/jayarrowz/mcp-osrs.git cd mcp-osrs npm install npm run build

调试方式

  1. 启动开发模式bash npm start

  2. 构建服务器bash npm run build

  3. 使用示例javascript // 搜索 OSRS Wiki const result = await callTool("osrs_wiki_search", { search: "Abyssal whip" });

javascript // 获取页面信息 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", {});

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。