Runescape Wiki MCP

🚀 RuneScape Wiki MCP服務器

RuneScape Wiki MCP服務器是一個模型上下文協議（MCP）服務器，它提供對RuneScape Wiki API的訪問，包括RuneScape 3（RS3）的即時大交易所價格、物品數據和玩家統計信息。

🚀 快速開始

本服務器提供了對RuneScape Wiki API的訪問，可獲取RuneScape 3的即時大交易所價格、物品數據和玩家統計信息。以下是使用本服務器的快速指南。

✨ 主要特性

• 即時大交易所價格：獲取所有物品的當前價格、5分鐘平均價格和1小時平均價格。
• 物品數據庫：訪問包含元數據（名稱、ID、檢查文本等）的完整物品映射。
• 價格時間序列：提供可配置時間間隔的歷史價格數據。
• 玩家統計信息：從RuneScape 3排行榜查詢玩家統計信息。
• 多種遊戲模式：支持普通、鐵人模式和硬核鐵人模式賬戶。
• MCP資源：通過MCP資源URI直接訪問價格和物品數據。

📦 安裝指南

前提條件

• Node.js 18.0.0或更高版本
• npm或yarn

安裝依賴

npm install

構建項目

npm run build

開發模式

npm run dev

這將啟動TypeScript編譯器的監視模式，並在文件更改時自動重啟服務器。

💻 使用示例

與Claude Desktop配合使用

將以下配置添加到你的Claude Desktop配置文件中：

{
  "mcpServers": {
    "runescape-wiki": {
      "command": "node",
      "args": ["/path/to/runescape-wiki-mcp/dist/index.js"]
    }
  }
}

與MCP Inspector配合使用

使用MCP Inspector測試服務器：

# 使用npm腳本（推薦）
npm run inspector

# 或者手動使用npx
npx @modelcontextprotocol/inspector node dist/index.js

快速測試

驗證服務器是否正常工作：

npm test

📚 詳細文檔

可用工具

get_latest_prices

獲取所有物品或特定物品的最新大交易所價格。 參數：

• itemId（可選）：要獲取價格的特定物品的ID。 示例：

{
  "itemId": 4151
}

get_item_mapping

獲取所有物品的完整映射，包括其ID、名稱和元數據。 參數：無 返回：物品數組，包含以下信息：

• id：物品ID
• name：物品名稱
• examine：檢查文本
• members：是否為會員專屬物品
• lowalch：低鍊金術價值
• highalch：高鍊金術價值
• limit：大交易所購買限制
• value：物品價值
• icon：圖標文件名

get_5m_prices

獲取所有物品的5分鐘平均價格。 參數：

• timestamp（可選）：要獲取特定時間價格的Unix時間戳。

get_1h_prices

獲取所有物品的1小時平均價格。 參數：

• timestamp（可選）：要獲取特定時間價格的Unix時間戳。

get_timeseries

獲取特定物品的價格時間序列數據。 參數：

• itemId（必需）：要獲取時間序列的物品ID。
• timestep（必需）：時間間隔 - 可選值：5m、1h、6h、24h。 示例：

{
  "itemId": 4151,
  "timestep": "1h"
}

get_player_stats

從RuneScape 3排行榜查詢玩家統計信息。 參數：

• username（必需）：要查詢的玩家用戶名。
• gameMode（可選）：遊戲模式 - 可選值：normal、ironman、hardcore。 示例：

{
  "username": "Zezima",
  "gameMode": "normal"
}

返回：解析後的統計信息，包括：

• 總體排名和總等級
• 各個技能的等級、經驗和排名
• 所有30個技能（包括召喚、地下城、占卜、發明、考古和死靈術）的格式化數據

物品類別映射

在使用需要類別編號的工具（如search_items）時，請參考此表。

可用資源

• runescape://prices/latest：直接訪問所有物品的最新大交易所價格。
• runescape://items/mapping：直接訪問完整的物品映射數據。

API端點

本服務器使用以下RuneScape Wiki API：

• RS3價格API：https://prices.runescape.wiki/api/v1/rs
  • 最新價格、5分鐘平均價格、1小時平均價格、時間序列數據
• RS3排行榜API：https://secure.runescape.com/m=hiscore
  • 不同遊戲模式的玩家統計信息

速率限制

RuneScape Wiki API有以下使用指南：

• 使用描述性的User-Agent（本服務器會自動處理）
• 避免發出可能影響API穩定性的過多請求
• 服務器實現了適當的錯誤處理，並遵守API限制

錯誤處理

服務器包含全面的錯誤處理：

• 捕獲API請求失敗並作為錯誤響應返回
• 在進行API調用之前驗證無效參數
• 優雅地處理網絡超時和連接問題
• 正確報告未找到玩家的錯誤

🔧 技術細節

項目結構

src/
├── index.ts          # 主服務器實現
├── types/            # TypeScript類型定義
└── utils/            # 實用函數

dist/                 # 編譯後的JavaScript輸出

腳本

• npm run build：將TypeScript編譯為JavaScript
• npm run watch：監視文件更改並重新編譯
• npm start：在生產模式下啟動服務器
• npm run dev：在開發模式下啟動，具有自動重啟功能
• npm test：運行簡單測試以驗證服務器是否正常工作
• npm run inspector：啟動MCP Inspector以測試服務器

添加新工具

1. 在tools數組中定義工具，並使用適當的架構。
2. 在CallToolRequestSchema處理程序中添加案例處理程序。
3. 實現具有適當錯誤處理的API邏輯。
4. 更新此README文檔以提供文檔說明。

📄 許可證

本項目採用MIT許可證，詳情請參閱LICENSE文件。

致謝

• RuneScape Wiki 提供API
• Model Context Protocol 提供MCP規範
• Jagex 開發RuneScape 3

支持

如有問題、疑問或功能請求，請在GitHub倉庫中創建一個issue。

⚠️ 重要提示

這是一個非官方工具，與Jagex或RuneScape Wiki沒有關聯。請遵守API使用指南和服務條款。