ManualSlima MCP › Cómo funcionan las versiones de slima-mcp

Cómo funcionan las versiones de slima-mcp

Última actualización 9/09/2026 · 7 min de lectura

En una línea: cómo funcionan las versiones de slima-mcp — el servidor no bloquea las antiguas, una versión antigua simplemente tiene menos herramientas que llamar, y aquí está cómo saber cuál estás ejecutando.

La versión actual

slima-mcp 0.3.0, publicada el 2026-09-09. La anterior, 0.2.0, es del 2026-04-24: más de cuatro meses antes, así que aquí «una versión de diferencia» engaña.

0.2.0 traía las herramientas de obras, archivos y Lector Beta IA. Lo que añadió 0.3.0:

  • Las herramientas de edición estructurada (update_beat_board / update_timeline / update_script / update_relationship_map / update_world_map)
  • El conjunto de enseñanza (get_capabilities / list_guides / load_guide / list_writing_skills / load_writing_skill)
  • Notas, comentarios y semantic_search
  • view_relationship_map
  • get_reader_test, para recoger un informe del Lector Beta IA que tardó más que la ventana de espera

Cómo ve el servidor tu versión

Cada llamada lleva la versión del cliente en su User-Agent. El servidor la compara con dos umbrales:

Umbral Ahora mismo Qué significa
Recomendada 0.3.0 Por debajo recibes un aviso de actualización, y todo sigue funcionando
Mínimo obligatorio 0.1.0 Solo por debajo de esta línea se te rechaza. Está reservada para cambios de seguridad o rupturas

Así que ir atrasado nunca es una negativa de servicio. Las herramientas de un cliente antiguo siguen funcionando. Lo que le falta son herramientas que llamar: el servidor no esconde nada, es que esas herramientas no existen en la copia del paquete que tienes.

Cuando vas atrasado aparecen dos señales:

  • Cada respuesta lleva una cabecera X-Slima-MCP-Upgrade-Hint con la versión recomendada y la tuya
  • Los mensajes de error incorporan un párrafo extra explicando la actualización

Por qué esta versión en concreto vale la pena

El servidor 4.0 cerró la escritura de archivo completo en .map, .beats, .timeline, .script y .geomap, y 0.2.0 no tiene ninguna de las herramientas update_*. Las dos vías están cerradas a la vez, lo que significa que una IA externa ejecutando 0.2.0 no puede editar esos cinco tipos de archivo en absoluto.

Lo incómodo es lo que ve el usuario: no un «actualiza, por favor», sino herramientas que fallan una y otra vez. Por eso este aviso concreto es menos una sugerencia que una explicación de por qué algo dejó de funcionar.

Saber qué versión estás ejecutando

Conectores web (claude.ai, ChatGPT): nada que comprobar y nada que hacer. El servidor remoto siempre está al día y tu próxima conversación ya corre sobre la versión nueva.

En local (Claude Desktop, Cursor, Gemini CLI, VS Code):

# la versión que realmente vas a ejecutar
npx -y slima-mcp@0 --version

# la versión más reciente en npm
npm view slima-mcp version

# cualquier instalación global olvidada: el sospechoso habitual
npm ls -g slima-mcp

Si las dos primeras no coinciden, algo te está anclando a la antigua.

Cómo actualizar

Si tu configuración usa npx: quita antes la instalación global y reinicia el cliente.

npm uninstall -g slima-mcp

Ese paso no es limpieza, es obligatorio. npx pkg@<rango> satisface el rango con un paquete que ya esté en tu PATH y no llega a consultar el registro. Medido el 2026-09-09, con una global 0.2.0 presente y 0.3.0 en npm:

Comando Resolvió a
npx -y slima-mcp@0 0.2.0 — usó la instalación global
npx -y slima-mcp 0.2.0 — igual
npx -y slima-mcp@latest 0.3.0 — una dist-tag obliga a consultar el registro
npx -y [email protected] 0.3.0 — la copia global no puede satisfacer una versión exacta más nueva

O sea que una instalación global caducada hace que la forma con npx deje de actualizarse para siempre, mientras el servidor te sigue pidiendo que actualices.

⚠️ Revisa todos los sitios donde puedas haberlo instalado. Una instalación global puede existir una vez por cada entorno del gestor de versiones de Node y otra vez por sistema operativo. En WSL es habitual tener una bajo nvm y otra bajo el AppData/Roaming/npm de Windows, con versiones distintas y solo una de ellas en el PATH que usa de verdad tu cliente MCP.

Si prefieres quedarte con la instalación global: acuérdate de ejecutar esto tú mismo de vez en cuando.

npm install -g slima-mcp@latest

Por qué las configuraciones dicen @0 y no @latest

Esa es otra pregunta, y va sobre los cambios que rompen en la versión mayor: Por qué slima-mcp@0. El traslado completo de una instalación global a npx está en Migrar de la instalación global a npx.

Relacionado

Pruébalo en Slima

Abre la app y hazlo con tu propio libro. Gratis para empezar, sin tarjeta de crédito.

Abrir Slima
¿Te resultó útil?