OSRS MCP Server
OSRS MCP 服务器
MCP 服务器用于与 Old School RuneScape (OSRS) Wiki API 和数据文件交互。该服务器提供搜索 OSRS Wiki 和通过模型上下文协议 (MCP) 访问游戏数据定义的工具。
工具
该服务器实现了以下工具:
OSRS Wiki 方法
osrs_wiki_search- 在 OSRS Wiki 中搜索与搜索词匹配的页面osrs_wiki_get_page_info- 获取有关 OSRS Wiki 上特定页面的信息osrs_wiki_parse_page- 获取特定 OSRS Wiki 页面的已解析 HTML 内容
游戏数据搜索方法
search_varptypes- 在 varptypes.txt 文件中搜索存储玩家状态和进度的玩家变量 (varps)search_varbittypes- 在 varbittypes.txt 文件中搜索存储 varps 中各个位的变量位 (varbits)search_iftypes- 在 iftypes.txt 文件中搜索游戏 UI 中使用的接口定义search_invtypes- 在 invtypes.txt 文件中搜索游戏中的库存类型定义search_loctypes- 在 loctypes.txt 文件中搜索游戏世界中的位置/对象类型定义search_npctypes- 在 npctypes.txt 文件中搜索 NPC(非玩家角色)定义search_objtypes- 在 objtypes.txt 文件中搜索游戏中的对象/物品定义search_rowtypes- 在 rowtypes.txt 文件中搜索各种接口中使用的行定义search_seqtypes- 在 seqtypes.txt 文件中搜索动画序列定义search_soundtypes- 在 soundtypes.txt 文件中搜索游戏中的音效定义search_spottypes- 在 spottypes.txt 文件中搜索点动画(图形效果)定义search_spritetypes- 在 spritetypes.txt 文件中搜索界面中使用的精灵图像定义search_tabletypes- 在 tabletypes.txt 文件中搜索接口选项卡定义
通用数据文件方法
search_data_file- 在数据目录中的任何文件中搜索匹配的条目get_file_details- 获取数据目录中文件的详细信息list_data_files- 列出数据目录中可用的数据文件
Related MCP server: Wiki OSRS MCP
安装
通过 Smithery 安装
要通过Smithery自动为 Claude Desktop 安装 mcp-osrs:
npx @smithery/cli@latest install @jayarrowz/mcp-osrs --client claude先决条件
Node.js(v16 或更高版本)
npm 或 yarn
安装包
# Clone the repository
git clone https://github.com/jayarrowz/mcp-osrs.git
cd mcp-osrs
# Install dependencies
npm install
# Build the package
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 Wiki
// Search for information about the Abyssal whip
const result = await callTool("osrs_wiki_search", {
search: "Abyssal whip"
});获取页面信息
// Get information about a specific wiki page
const pageInfo = await callTool("osrs_wiki_get_page_info", {
titles: "Abyssal_whip"
});搜索游戏数据
// Search for items in the object definitions
const items = await callTool("search_objtypes", {
query: "dragon",
page: 1,
pageSize: 10
});列出可用的数据文件
// Get a list of all data files
const files = await callTool("list_data_files", {});发展
# Install dependencies
npm install
# Start the server in development mode
npm start
# Build the server
npm run build执照
此 MCP 服务器采用 MIT 许可证。这意味着您可以自由使用、修改和分发该软件,但须遵守 MIT 许可证的条款和条件。更多详情,请参阅项目仓库中的 LICENSE 文件。
Available Tools
23 toolsget_file_detailsC
Get details about a file in the data directory.
Inputs: filename (required).
get_ge_latestA
Get the latest Grand Exchange high and low prices for a specific item by its ID.
Inputs: itemId (required).
get_ge_timeseriesA
Get historical time-series price data for an item at a given interval (5m, 1h, 6h, 24h). Returns up to 365 data points.
Inputs: itemId (required), timestep (required).
list_data_filesB
List available data files in the data directory.
Inputs: fileType.
lookup_playerA
Look up an OSRS player's stats (skills, bosses, clue scrolls, and activities) from the official hiscores.
Inputs: playerName (required), gamemode.
osrs_wiki_get_page_infoC
Get information about specific pages on the OSRS Wiki.
Inputs: titles (required).
osrs_wiki_parse_pageC
Get the parsed HTML content of a specific OSRS Wiki page.
Inputs: page (required).
osrs_wiki_searchC
Search the OSRS Wiki for pages matching a search term.
Inputs: search (required), limit, offset.
search_data_fileC
Search any file in the data directory for matching entries.
Inputs: filename (required), query (required), page, pageSize.
search_ge_itemsA
Search for Grand Exchange tradeable items by name. Uses an exact/prefix/substring match. Returns item IDs, names, buy limits, and alch values.
Inputs: query (required), page, pageSize.
search_iftypesC
Search the iftypes.txt file for interface definitions used in the game's UI.
Inputs: query (required), page, pageSize.
search_invtypesC
Search the invtypes.txt file for inventory type definitions in the game.
Inputs: query (required), page, pageSize.
search_loctypesC
Search the loctypes.txt file for location/object type definitions in the game world.
Inputs: query (required), page, pageSize.
search_npctypesC
Search the npctypes.txt file for NPC (non-player character) definitions.
Inputs: query (required), page, pageSize.
search_objtypesC
Search the objtypes.txt file for object/item definitions in the game.
Inputs: query (required), page, pageSize.
search_rowtypesC
Search the rowtypes.txt file for row definitions used in various interfaces.
Inputs: query (required), page, pageSize.
search_seqtypesC
Search the seqtypes.txt file for animation sequence definitions.
Inputs: query (required), page, pageSize.
search_soundtypesC
Search the soundtypes.txt file for sound effect definitions in the game.
Inputs: query (required), page, pageSize.
search_spottypesC
Search the spottypes.txt file for spot animation (graphical effect) definitions.
Inputs: query (required), page, pageSize.
search_spritetypesC
Search the spritetypes.txt file for sprite image definitions used in the interface.
Inputs: query (required), page, pageSize.
search_tabletypesC
Search the tabletypes.txt file for interface tab definitions.
Inputs: query (required), page, pageSize.
search_varbittypesC
Search the varbittypes.txt file for variable bits (varbits) that store individual bits from varps.
Inputs: query (required), page, pageSize.
search_varptypesC
Search the varptypes.txt file for player variables (varps) that store player state and progress.
Inputs: query (required), page, pageSize.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 23 tools
Many search_* tools are very similar in function, only differing by the file they search. While descriptions specify which file, an agent could easily confuse them, especially with many type definition tools.
Tools consistently use snake_case and start with verbs like get, lookup, search, list. However, some tools use an 'osrs_wiki_' prefix while others do not, creating minor inconsistency.
23 tools is slightly above the typical well-scoped range but is reasonable for a comprehensive OSRS server covering wiki, hiscores, GE, and many game definition searches.
Covers major areas like wiki, hiscores, GE, and extensive type definitions. Some gaps (e.g., quests, combat calculations) but overall a solid surface for OSRS tasks.
Maintenance
Related MCP Connectors
Search and inspect source-pinned agent skills, plugins and tools through a free public MCP.
Web search API and MCP server for developers building AI agents.
Read and write your team's shared, AI-readable wiki from any MCP client.
Search your AI chat history (ChatGPT, Claude, Codex) from any MCP client. Remote, private, read-only
Related MCP Servers
AlicenseBqualityNot gradedmaintenanceMCP Server for interacting with Old School RuneScape Wiki API and game data files, providing tools to search the OSRS Wiki and access game data definitions through the Model Context Protocol.1950 npm1-- FlicenseNot gradedqualityDmaintenanceProvides access to Old School RuneScape wiki information and game data through MCP tools. Enables users to query OSRS game content, items, and mechanics via natural language.1-
- AlicenseNot gradedqualityDmaintenanceThis server enables interaction with the Old School RuneScape (OSRS) Wiki API and provides access to extensive game data definitions for items, NPCs, and interfaces. It allows users to search the wiki and query underlying game files through the Model Context Protocol.MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to search the OSRS Wiki, lookup Grand Exchange prices, and access synced player data (bank, skills, quests, etc.) via local RuneLite plugin files.131BSD 2-Clause "Simplified"