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使用指南和服务条款。