RuneScape

mcp-server-runescape

Este es un servidor MCP con herramientas para interactuar con datos de RuneScape (RS) y Old School RuneScape (OSRS), incluyendo precios de objetos, hiscores de jugadores y más.

https://github.com/user-attachments/assets/7c141575-443b-4b76-8b33-6d48ec82fbe7

Características

El servidor MCP proporciona varias herramientas que se utilizan para responder tus preguntas durante el juego con datos de fuentes precisas.

1. Detalles del objeto (get_item_details)

Obtén información completa sobre objetos comerciables, incluyendo:

• Precio actual en el Grand Exchange
• Tendencias de precios (24h, 30, 90 y 180 días)
• Nombre
• Categoría
• Descripción (texto de examinar)
• Imagen
• Miembros
• ID

https://runescape.wiki/w/Application_programming_interface#detail

2. Historial de precios del objeto (get_item_price_history)

Accede al historial de precios de un objeto durante los últimos 180 días, incluyendo:

• Precio en un día dado (marca de tiempo)
• Precio promedio en un día dado (marca de tiempo)

https://runescape.wiki/w/Application_programming_interface#Graph

3. Hiscore del jugador (get_player_hiscore)

Obtén clasificaciones y experiencia para habilidades y actividades de cualquier jugador, incluyendo:

• Rango del jugador
• Nivel de habilidad
• Puntos de experiencia
• Puntuaciones de actividad

https://runescape.wiki/w/Application_programming_interface#Hiscores_Lite_2

4. Mejores clasificaciones (get_top_rankings)

Ve los mejores (máx. 50) jugadores para una habilidad o actividad específica, incluyendo:

• Nombre
• Puntuación (usada tanto para habilidad como para actividad)
• Rango

https://runescape.wiki/w/Application_programming_interface#ranking

5. Conteo de jugadores (get_player_count)

Obtiene el número de jugadores actualmente en línea en RuneScape y Old School RuneScape, incluyendo:

• Conteos de jugadores en tiempo real

https://runescape.wiki/w/Application_programming_interface#player_count

6. Totales de cuentas (get_rsuser_total)

Obtiene la cantidad actual de cuentas creadas que pueden acceder a cualquier forma de RuneScape. Esto incluye cuentas hechas en FunOrb o una versión particular de RuneScape, incluyendo:

• Datos históricos de creación de cuentas

https://runescape.wiki/w/Application_programming_interface#rsusertotal

Nota

Por consistencia, intenté usar solo endpoints de API que soporten datos tanto de RS como de OSRS.

Ejemplos de uso

El objetivo es que tengas una forma fácil de obtener datos más precisos directamente de la fuente mientras haces scraping.

Aquí hay algunos ejemplos de consultas que puedes hacerle a la IA al usar este servidor MCP:

Detalles del objeto

"What is the price of a dragon scimitar in the Grand Exchange?"
"Torva full helm price"
"Current price of a dragon pickaxe"
"How much percentage has the price of a dragon pickaxe changed in the past 30 days?"
"How much percentage has the price of a dragon pickaxe changed in the past 90 days?"
"How much percentage has the price of a dragon pickaxe changed in the past 180 days?"
"Give me the description of an armadyl godsword"
"Give me the icon of a dragon scimitar"
"What is the id of an abbyssal whip?"

Historial de precios del objeto

"Give me the price history of a dragon scimitar"
"Rune scimitar price on 1 april 2025?"

Hiscore del jugador

"What rank is Zezima?"
"What rank is Zezima on runescape?"
"How much experience does Lynx Titan have overall?"
"Iron Hyger ironman rank?"

Mejores clasificaciones

"Top 10 players overall?"
"Give me the top 50 attack rankings"
"Number one agility on runescape?"
"Most zulrah kills?"
"Give me the top 5 jad rankings"

Primeros pasos

Introducción a los servidores MCP

Puedes usar el servidor MCP en muchos clientes, por ejemplo:

• Claude desktop
• Cursor

1. Añade el servidor MCP en tu configuración (paquete NPM)

Pega este fragmento en tu configuración de mcp que tu cliente está usando

{
  "mcpServers": {
    "mcp-server-runescape": {
      "command": "npx",
      "args": ["-y", "mcp-server-runescape"]
    }
  }
}

Puedes encontrar el archivo de configuración en (mac):

• Claude desktop:

~/Library/Application Support/Claude/claude_desktop_config.json

• Cursor:

/Users/name/.cursor/mcp.json

2. Desde el código fuente

Requisito Node.js instalado en tu sistema

1. Clona este repositorio
2. Instala las dependencias:

   yarn
   

   o

   npm install
   

3. Luego actualiza tu Claude desktop o Cursor con:

   {
     "mcpServers": {
       "mcp-server-runescape": {
         "command": "node",
         "args": ["/Users/path/to/mcp-server-runescape/src/server.js"]
       }
     }
   }
   

4. Opcional: Ejecuta el depurador/inspector

   yarn dev
   

   o

   npm run build
   

Asegúrate de:

• Reemplaza /path/to/mcp-server-runescape con la ruta real a tu instalación.

Después de actualizar la configuración, reinicia Claude desktop o Cursor para que los cambios surtan efecto.

Preferencia personal

Puedes usar cualquier cliente que quieras, mi preferencia personal va hacia Cursor en este momento en combinación con deepseek-v3.1 que está funcionando muy bien.

Lista de clientes

Documentación de la API

Para información detallada sobre los endpoints de la API de RuneScape utilizados por este servidor MCP, visita: RS/Wiki API

Gracias

Construí esto durante el fin de semana, para aprender un poco más sobre los servidores MCP. RuneScape fue el tema perfecto para probarlo.

• Un agradecimiento al equipo de rs/wiki por la documentación y la API.

Si esto te ayuda de alguna manera al hacer scraping y quieres apoyarme, no dudes en