Scrivener MCP

Scrivener MCP

Conecta tus proyectos de Scrivener a Claude, ChatGPT y otros asistentes de IA

Instalación · Qué puedes hacer · Todas las herramientas · Guías · Contribuciones

Scrivener MCP permite que tu asistente de IA abra, lea, edite, analice y busque en tus proyectos de Scrivener directamente. Sin copiar y pegar. Sin exportar. Dile a tu asistente qué proyecto abrir y empieza a trabajar.

Tú: Abre mi novela y analiza el ritmo en el Capítulo 12.

Claude: Abre tu proyecto .scriv, lee el Capítulo 12 y ejecuta el análisis de ritmo. La primera mitad avanza bien con párrafos cortos y tensos. La sección central se ralentiza considerablemente: el monólogo interno de tres páginas que comienza en el párrafo 14 frena el impulso que construiste en la escena de confrontación. Considera reducirlo a un solo párrafo y mover el trasfondo al Capítulo 8, donde se presenta a Elena por primera vez.

Funciona con Claude Desktop, Claude Code, VS Code (Copilot/Continue), Cursor y cualquier cliente compatible con MCP. Scrivener 3 en macOS, Windows y Linux. Listado en el registro oficial de MCP como io.github.writerslogic/scrivener-mcp.

Instalación

Elige el método que mejor te funcione. La mayoría configuran automáticamente Claude Desktop durante la instalación. Claude Code y otros clientes necesitan un paso adicional: consulta Claude Code más abajo.

npm (recomendado)

npm install -g scrivener-mcp

Reinicia Claude Desktop. Listo.

Claude Code

Instalar el paquete npm no registra el servidor en Claude Code: la configuración automática durante la instalación solo escribe la configuración de Claude Desktop. Después de instalar, registra el servidor:

npx scrivener-setup

Esto detecta Claude Code (junto con Claude Desktop y Cursor) y escribe la configuración por ti. Para registrarlo manualmente:

claude mcp add -s user scrivener -- npx scrivener-mcp

Luego reinicia Claude Code (o ejecuta /mcp para reconectar) y Scrivener MCP aparecerá en la lista de servidores. Añade -s user para limitarlo al proyecto actual en lugar de a todos los proyectos.

Smithery

npx -y @smithery/cli install scrivener-mcp --client claude

npx (sin instalación)

Úsalo directamente sin instalación global:

npx scrivener-mcp

O añádelo manualmente a la configuración de Claude Desktop:

{
  "mcpServers": {
    "scrivener": {
      "command": "npx",
      "args": ["scrivener-mcp"]
    }
  }
}

GitHub

Instala directamente desde el repositorio (última versión de main):

npm install -g writerslogic/scrivener-mcp

O una versión específica:

npm install -g writerslogic/scrivener-mcp#v0.12.0

Homebrew (macOS)

brew install writerslogic/tap/scrivener-mcp

Docker

docker build -t scrivener-mcp https://github.com/writerslogic/scrivener-mcp.git
docker run -i --rm -v /path/to/your/projects:/projects scrivener-mcp

npx scrivener-setup

security add-generic-password -s anthropic-api-key -a anthropic -w sk-ant-your-key-here

export ANTHROPIC_API_KEY="sk-ant-..."   # or OPENAI_API_KEY="sk-..."

Qué puedes hacer

Primero, abre un proyecto. El servidor actúa sobre el proyecto .scriv al que lo apuntes: no tiene vínculo con la aplicación Scrivener y no puede ver lo que tienes abierto allí. Comienza una conversación con "Abre mi proyecto de Scrivener en ~/Documents/My Novel.scriv" (o "Descubre mis proyectos de Scrivener" si no conoces la ruta) y luego da tus comandos. En macOS también puedes decir "Usa el proyecto que tengo abierto en Scrivener": detecta el proyecto abierto y lo abre (la primera vez, macOS te pedirá permiso para controlar Scrivener). Haz esto una vez al inicio de cada conversación; los ejemplos a continuación asumen que hay un proyecto abierto. Si el mismo proyecto también está abierto y sin guardar en la aplicación Scrivener, guárdalo o ciérralo allí primero para evitar escrituras conflictivas.

Gestiona tu manuscrito

Abre cualquier proyecto de Scrivener y trabaja con él de forma natural. Lee capítulos, crea nuevas escenas, reorganiza el binder, actualiza sinopsis: todo mediante conversación.

Tú: Crea una nueva escena llamada "La revelación" después del Capítulo 5 y mueve el epílogo antiguo a la papelera.

Analiza tu escritura

Obtén comentarios detallados sobre legibilidad, ritmo, estilo, calidad del diálogo y arco emocional. No son consejos genéricos: análisis fundamentado en tu prosa real.

Tú: Analiza el Capítulo 3. ¿El ritmo es demasiado lento?

Claude: La legibilidad es buena (grado Flesch-Kincaid 8.2), pero el ritmo presenta señales:

• 4 párrafos consecutivos de monólogo interno (líneas 45-78) sin acción ni diálogo
• La escena tiene 3,200 palabras con solo 2 cortes de escena: tus otros capítulos promedian 4
• La densidad de palabras filtro es 2 veces el promedio de tu manuscrito ("sentía", "parecía", "notaba") Sugerencias específicas: ...

Mejora tu prosa

Aplica mejoras específicas: elimina palabras filtro, fortalece verbos, varía la estructura de las oraciones, añade detalles sensoriales, convierte mostrar en contar, ajusta el diálogo, equilibra el ritmo.

Tú: Elimina las palabras filtro del Capítulo 7 y fortalece los verbos.

Da seguimiento a personajes y trama

Guarda perfiles de personajes, hilos argumentales y guías de estilo que persisten con tu proyecto. La IA recuerda a tus personajes entre sesiones.

Tú: Guarda un perfil de personaje para Marcus: detective retirado, cínico pero justo, camina con una cojera por una lesión antigua, habla con frases cortas.

Más tarde...

Tú: Verifica si Marcus es consistente en todos los capítulos.

Claude: Encontré una inconsistencia: Marcus camina "enérgicamente" en el Capítulo 9 (línea 34), pero su cojera se menciona en los Capítulos 2, 5 y 11. Además, su diálogo en el Capítulo 4 usa oraciones largas y fluidas, lo que contradice la nota de "frases cortas" en su perfil.

Busca por significado

Encuentra pasajes por su contenido, no solo por coincidencia de palabras clave. "Encuentra escenas donde el protagonista se siente aislado" funciona incluso si la palabra "aislado" nunca aparece. El índice del proyecto y la puntuación de similitud se ejecutan localmente mediante el Sistema de Memoria Holográfica; el pipeline de búsqueda actual también usa tu proveedor de IA configurado para la interpretación de consultas y las explicaciones de resultados, por lo que semantic_search requiere un proveedor.

Tú: Encuentra todas las escenas donde Elena y Marcus están solos juntos.

Da seguimiento a relaciones

Guarda y consulta relaciones entre personajes, lugares, temas e hilos argumentales. No se necesita Neo4j: las relaciones viven en el motor de memoria semántica y persisten con tu proyecto.

Tú: ¿Quién está conectado con Marcus? ¿Qué hilos argumentales involucran el faro?

Compila y exporta

Combina capítulos en un solo manuscrito con formato configurable, separadores y preservación de la estructura. Exporta el resultado en línea como Markdown, HTML o JSON, o escribe un archivo DOCX, EPUB o PDF en disco para envío, lectores electrónicos o impresión.

Todas las herramientas

57 herramientas organizadas por flujo de trabajo. Para mantener bajo el uso de tokens, las herramientas se cargan progresivamente: herramientas de proyecto al inicio, herramientas de documentos y búsqueda cuando abres un proyecto, y el resto bajo demanda (tu cliente de IA las activa automáticamente, o las llama directamente y la habilidad correspondiente se activa sobre la marcha). Establece SCRIVENER_MCP_EAGER_TOOLS=1 para cargar todo de una vez.

Guías

• Primeros pasos -- Instalación, configuración, tu primera sesión
• Configuración del cliente MCP -- Configuración de copiar y pegar para Claude Desktop, Claude Code, Cursor y VS Code
• Escribir con IA -- Flujos de trabajo de análisis, estrategias de mejora, gestión de memoria
• Solución de problemas -- Problemas comunes y soluciones
• Optimización de tokens -- Cómo el servidor minimiza el uso de la ventana de contexto
• Arquitectura -- Cómo funciona el servidor, estructura de módulos, flujo de datos
• Compatibilidad con Scrivener -- Versiones de Scrivener compatibles, plataformas y cobertura de formatos
• Formato de archivo Scrivener -- El formato .scriv de ingeniería inversa, qué leemos vs. inferimos, y guía de modificación segura
• Fuzzing -- Objetivo de Jazzer.js y detalles de integración con OSS-Fuzz
• Contribuir -- Configuración de desarrollo, convenciones de código, añadir nuevas herramientas

Requisitos

• Node.js 18+
• Archivos de proyecto de Scrivener 3 (.scriv)
• macOS, Windows o Linux
• Opcional: clave API de Anthropic, OpenAI u OpenRouter para funciones de IA respaldadas por proveedor
• Opcional: Neo4j para persistencia y consultas de grafos avanzadas; las herramientas de relaciones principales funcionan sin él

Desarrollo

git clone https://github.com/writerslogic/scrivener-mcp.git
cd scrivener-mcp
npm install
npm run dev          # Development mode with hot reload
npm run build        # Compile TypeScript
npm test             # Run tests
npm run typecheck    # Type checking only

¿Por qué este?

Existen varios servidores MCP de Scrivener. Esta comparación se basa en la documentación pública de cada proyecto, el paquete publicado y la superficie de herramientas anunciada a fecha de 2026-08-07. "No" significa que el proyecto no documenta esa capacidad; no afirma que la capacidad sea imposible a través del cliente de IA conectado.

Los recuentos y las afirmaciones de características pueden cambiar. Sigue los proyectos enlazados para su documentación más reciente; la fuente de comparación mantenida es docs/comparison.yml.

Contribuir

Agradecemos contribuciones de todos los tamaños. Consulta el rastreador de problemas para las etiquetas good first issue, o consulta la guía de contribución para la configuración de desarrollo.

Áreas donde la ayuda es especialmente bienvenida:

• Cobertura de pruebas (#18)
• Pruebas en Windows y manejo de rutas
• Pruebas de compatibilidad con Scrivener 2
• Mejoras de documentación (#25)

Seguridad

¿Encontraste una vulnerabilidad? Por favor, repórtala de forma privada -- consulta SECURITY.md.

Licencia

AGPL-3.0 © WritersLogic, Inc.

Gratis para uso personal y proyectos de código abierto. Licencia comercial disponible para integración propietaria. Consulta COMMERCIAL_LICENSE.md para más detalles.

GitHub · npm · Issues · Changelog