OSRS MCP Server
Servidor OSRS MCP 
Servidor MCP para interactuar con la API y los archivos de datos de la wiki de Old School RuneScape (OSRS). Este servidor proporciona herramientas para buscar en la wiki de OSRS y acceder a las definiciones de datos del juego mediante el Protocolo de Contexto de Modelo.
Herramientas
Este servidor implementa las siguientes herramientas:
Métodos wiki de OSRS
osrs_wiki_search: busca en la wiki de OSRS páginas que coincidan con un término de búsquedaosrs_wiki_get_page_info- Obtener información sobre páginas específicas en el Wiki de OSRSosrs_wiki_parse_page: obtiene el contenido HTML analizado de una página wiki de OSRS específica
Métodos de búsqueda de datos del juego
search_varptypes- Busca en el archivo varptypes.txt las variables de jugador (varps) que almacenan el estado y el progreso del jugadorsearch_varbittypes- Busca en el archivo varbittypes.txt bits variables (varbits) que almacenan bits individuales de varpssearch_iftypes- Busca en el archivo iftypes.txt las definiciones de interfaz utilizadas en la interfaz de usuario del juegosearch_invtypes- Busca en el archivo invtypes.txt definiciones de tipos de inventario en el juegosearch_loctypes- Busca en el archivo loctypes.txt definiciones de tipo de ubicación/objeto en el mundo del juegosearch_npctypes- Busca definiciones de NPC (personajes no jugadores) en el archivo npctypes.txtsearch_objtypes- Busca en el archivo objtypes.txt definiciones de objetos/elementos en el juegosearch_rowtypes: busca en el archivo rowtypes.txt las definiciones de filas utilizadas en varias interfacessearch_seqtypes- Busca definiciones de secuencias de animación en el archivo seqtypes.txtsearch_soundtypes- Busca en el archivo soundtypes.txt definiciones de efectos de sonido en el juegosearch_spottypes- Busca en el archivo spottypes.txt definiciones de animación de puntos (efecto gráfico)search_spritetypes- Busca en el archivo spritetypes.txt las definiciones de imágenes de sprites utilizadas en la interfazsearch_tabletypes- Busca en el archivo tabletypes.txt las definiciones de las pestañas de la interfaz
Métodos de archivos de datos genéricos
search_data_file- Busca cualquier archivo en el directorio de datos para encontrar entradas coincidentesget_file_details- Obtener detalles sobre un archivo en el directorio de datoslist_data_files: enumera los archivos de datos disponibles en el directorio de datos
Related MCP server: Wiki OSRS MCP
Instalación
Instalación mediante herrería
Para instalar mcp-osrs para Claude Desktop automáticamente a través de Smithery :
npx @smithery/cli@latest install @jayarrowz/mcp-osrs --client claudePrerrequisitos
Node.js (v16 o posterior)
npm o hilo
Instalación del paquete
# Clone the repository
git clone https://github.com/jayarrowz/mcp-osrs.git
cd mcp-osrs
# Install dependencies
npm install
# Build the package
npm run buildUso con Claude Desktop
Agregue lo siguiente a su claude_desktop_config.json :
Usando npx
{
"mcpServers": {
"osrs": {
"command": "npx",
"args": ["-y", "@jayarrowz/mcp-osrs"]
}
}
}Node.js directo
{
"mcpServers": {
"osrs": {
"command": "node",
"args": ["/path/to/mcp-osrs/dist/index.js"]
}
}
}Reemplace /path/to/mcp-osrs con la ruta real a su repositorio.
Ejemplos
Buscar en la wiki de OSRS
// Search for information about the Abyssal whip
const result = await callTool("osrs_wiki_search", {
search: "Abyssal whip"
});Obtener información de la página
// Get information about a specific wiki page
const pageInfo = await callTool("osrs_wiki_get_page_info", {
titles: "Abyssal_whip"
});Buscar datos del juego
// Search for items in the object definitions
const items = await callTool("search_objtypes", {
query: "dragon",
page: 1,
pageSize: 10
});Lista de archivos de datos disponibles
// Get a list of all data files
const files = await callTool("list_data_files", {});Desarrollo
# Install dependencies
npm install
# Start the server in development mode
npm start
# Build the server
npm run buildLicencia
Este servidor MCP cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.
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"