项目简介

这是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型（LLM）客户端提供访问《Old School RuneScape》(OSRS) 游戏相关信息的能力。它通过标准化接口封装了对 OSRS Wiki API 和本地游戏数据文件的访问，使 LLM 能够获取最新的游戏内容信息和定义。

主要功能点

该服务器通过提供一系列工具，使 LLM 能够：

• 搜索 OSRS Wiki： 根据关键词查找维基页面。
• 获取 Wiki 页面信息： 根据页面标题获取详细信息。
• 解析 Wiki 页面内容： 获取特定维基页面的可读内容。
• 搜索游戏数据文件： 查找游戏内部各种定义（如物品、NPC、界面、变量等）的数据文件。
• 获取数据文件详情： 查看特定数据文件的大小、行数等信息。
• 列出可用数据文件： 查看服务器提供了哪些游戏数据文件供查询。

安装步骤

该服务器是基于 Node.js 环境运行的。

1. 前提条件： 确保您的系统已安装 Node.js (推荐 v16 或更高版本) 和 npm 或 yarn 包管理器。
2. 克隆仓库： 从 GitHub 下载项目代码到本地。

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

3. 安装依赖： 在项目目录下运行命令安装所需的库。

   npm install
   

4. 构建项目： 运行构建命令生成可执行文件。

   npm run build
   

此外，如果您使用支持 Smithery 的客户端（如 Claude Desktop），可以通过 Smithery 更方便地安装和管理。

服务器配置

MCP 服务器需要由 MCP 客户端（如 Claude Desktop）启动和连接。您需要在客户端的配置中指定如何启动这个服务器进程。通常，这涉及到提供一个服务器名称、启动命令（'command'）和启动参数（'args'）。

对于本服务器，您可以选择以下两种启动方式之一进行配置：

1. 使用 npx 启动： 如果您希望直接使用 npm 包，配置的 'command' 可以是 'npx'，'args' 参数包含 '@jayarrowz/mcp-osrs'。
2. 直接使用 Node.js 启动： 如果您手动克隆并构建了项目，配置的 'command' 可以是 'node'，'args' 参数包含项目构建后主文件的完整路径（例如 '/path/to/mcp-osrs/dist/index.js'）。请将 '/path/to/mcp-osrs' 替换为您实际克隆项目的路径。

具体的配置格式和位置请参考您使用的 MCP 客户端的官方文档。配置完成后，客户端在需要时会自动启动并连接到此 MCP 服务器。

基本使用方法

一旦服务器在客户端中配置并成功连接，LLM 将能够通过 MCP 协议调用服务器提供的工具。您可以通过向 LLM 提问或发送指令来利用这些工具，例如：

• 询问 LLM 关于某个物品（如“Abyssal whip”）在 OSRS Wiki 上的信息。
• 让 LLM 查找某个 NPC 的游戏定义。
• 请 LLM 搜索特定类型的游戏数据（如所有龙类物品）。
• 让 LLM 查看可用的游戏数据文件列表。

LLM 会识别您的意图并使用相应的工具来获取信息，然后将其整合到回复中。