MCP Osrs

🚀 OSRS MCP 服務器

這是一個用於與《oldschool runescape》（OSRS）維基 API 和數據文件交互的 MCP 服務器。該服務器提供了搜索 OSRS 維基和訪問遊戲數據定義的工具，方便開發者獲取遊戲相關信息。

🚀 快速開始

本服務器提供了多種工具用於與 OSRS 維基 API 和數據文件交互，能幫助您輕鬆搜索遊戲相關信息。以下將為您介紹具體的工具、安裝、配置、使用等內容。

✨ 主要特性

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

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 文件以查找遊戲界面定義
7. search_invtypes - 搜索 invtypes.txt 文件以查找遊戲庫存類型定義
8. search_loctypes - 搜索 loctypes.txt 文件以查找遊戲世界中的位置/對象類型定義
9. search_npctypes - 搜索 npctypes.txt 文件以查找非玩家角色（NPC）定義
10. search_objtypes - 搜索 objtypes.txt 文件以查找物品定義
11. search_searchtypes - 搜索 searchtypes.txt 文件以查找可搜索的物體定義
12. search_groundtypes - 搜索 groundtypes.txt 文件以查找地面物體定義

數據文件方法

13. list_data_files - 獲取所有可用數據文件的列表
14. get_file_info - 獲取特定文件的信息

📦 安裝指南

通過 Smithery 安裝

# 使用 Smithery 進行安裝

手動安裝

# 安裝依賴項
npm install

# 構建服務器
npm run build

# 啟動服務器（開發模式）
npm start

📚 詳細文檔

配置

在 config.json 中添加以下配置：

{
  "wiki apiUrl": "https://oldschool.runescape.wiki/api.php",
  "wiki username": "your-wiki-username",
  "wiki password": "your-wiki-password"
}

開發

# 安裝依賴項
npm install

# 在開發模式下啟動服務器
npm start

# 構建服務器
npm run build

💻 使用示例

基礎用法

搜索物品

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

獲取文件信息

// 獲取所有數據文件的列表
const files = await callTool("list_data_files", {});

// 獲取特定文件的信息
const fileInfo = await callTool("get_file_info", {
  file: "objtypes.json"
});

📄 許可證

此 MCP 服務器根據 MIT 許可證發佈。這意味著您可以自由使用、修改和分發軟件，但需遵守 MIT 許可證的條款和條件。有關詳細信息，請參閱項目存儲庫中的 LICENSE 文件。