# JayArrowz
## 基本信息
- Slug: `jayarrowz-mcp-osrs`
- Source: modelscope
- Publisher: @JayArrowz/mcp-osrs
- Categories: games-and-gamification / search / documentation-access
- Hosted: Yes
- License: MIT License
- Source URL: https://www.modelscope.cn/mcp/servers/@JayArrowz/mcp-osrs
## 简介
暂无描述。
## MCP Server 详情

# OSRS MCP 服务器 [![smithery 徽章](https://smithery.ai/badge/@jayarrowz/mcp-osrs)](https://smithery.ai/server/@jayarrowz/mcp-osrs)

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

<a href="https://glama.ai/mcp/servers/@JayArrowz/mcp-osrs">
  <img width="380" height="200" src="https://glama.ai/mcp/servers/@JayArrowz/mcp-osrs/badge" alt="OSRS 服务器 MCP 服务器" />
</a>

![image](https://github.com/user-attachments/assets/da9d1f48-513d-4a1b-a65b-56f8a012fa83)

![image](https://github.com/user-attachments/assets/9e7e4e07-6e47-44f9-ab0c-b3835418bd37)

![image](https://github.com/user-attachments/assets/628f35e1-2e85-42f4-8693-4ef4f16591d4)


## 工具

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

### 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` - 搜索数据目录中的任何文件以查找匹配项
18. `get_file_details` - 获取数据目录中文件的详细信息
19. `list_data_files` - 列出数据目录中可用的数据文件

## 安装

### 通过 Smithery 安装
要通过 [Smithery](https://smithery.ai/embed/@jayarrowz/mcp-osrs) 自动为 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文件。