MCP Osrs

🚀 OSRS MCP 服務器

OSRS MCP 服務器用於與舊版《符文工藝》（Old School RuneScape，簡稱 OSRS）維基 API 和數據文件進行交互。該服務器提供了一系列工具，可通過模型上下文協議搜索 OSRS 維基並訪問遊戲數據定義。

點擊此處

✨ 主要特性

此服務器實現了以下工具：

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 文件中搜索存儲 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 自動為 Claude Desktop 安裝 mcp-osrs，請執行以下命令：

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 維基

// 搜索關於 Abyssal whip 的信息
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 文件。