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úsqueda
osrs_wiki_get_page_info - Obtener información sobre páginas específicas en el Wiki de OSRS
osrs_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 jugador
search_varbittypes - Busca en el archivo varbittypes.txt bits variables (varbits) que almacenan bits individuales de varps
search_iftypes - Busca en el archivo iftypes.txt las definiciones de interfaz utilizadas en la interfaz de usuario del juego
search_invtypes - Busca en el archivo invtypes.txt definiciones de tipos de inventario en el juego
search_loctypes - Busca en el archivo loctypes.txt definiciones de tipo de ubicación/objeto en el mundo del juego
search_npctypes - Busca definiciones de NPC (personajes no jugadores) en el archivo npctypes.txt
search_objtypes - Busca en el archivo objtypes.txt definiciones de objetos/elementos en el juego
search_rowtypes : busca en el archivo rowtypes.txt las definiciones de filas utilizadas en varias interfaces
search_seqtypes - Busca definiciones de secuencias de animación en el archivo seqtypes.txt
search_soundtypes - Busca en el archivo soundtypes.txt definiciones de efectos de sonido en el juego
search_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 interfaz
search_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 coincidentes
get_file_details - Obtener detalles sobre un archivo en el directorio de datos
list_data_files : enumera los archivos de datos disponibles en el directorio de datos

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 claude

Prerrequisitos

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 build

Uso 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 build

Licencia

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.

OSRS MCP Server