Scrivener MCP

Scrivener MCP

Conecte seus projetos Scrivener ao Claude, ChatGPT e outros assistentes de IA

Instalação · O que você pode fazer · Todas as ferramentas · Guias · Contribuindo

O Scrivener MCP permite que seu assistente de IA abra, leia, edite, analise e pesquise seus projetos Scrivener diretamente. Sem copiar e colar. Sem exportar. Diga ao seu assistente qual projeto abrir e comece a trabalhar.

Você: Abra meu romance e analise o ritmo no Capítulo 12.

Claude: Abre seu projeto .scriv, lê o Capítulo 12 e executa a análise de ritmo. A primeira metade flui bem, com parágrafos curtos e tensos. A seção do meio desacelera consideravelmente -- o monólogo interno de três páginas que começa no parágrafo 14 interrompe o ritmo que você construiu na cena de confronto. Considere reduzi-lo a um único parágrafo e mover o histórico para o Capítulo 8, onde Elena é apresentada pela primeira vez.

Funciona com Claude Desktop, Claude Code, VS Code (Copilot/Continue), Cursor e qualquer cliente compatível com MCP. Scrivener 3 no macOS, Windows e Linux. Listado no registro oficial de MCP como io.github.writerslogic/scrivener-mcp.

Instalação

Escolha o método que funciona para você. A maioria configura automaticamente o Claude Desktop na instalação. O Claude Code e outros clientes precisam de uma etapa extra -- veja Claude Code abaixo.

npm (recomendado)

npm install -g scrivener-mcp

Reinicie o Claude Desktop. Pronto.

Claude Code

Instalar o pacote npm não registra o servidor no Claude Code -- a configuração automática na instalação grava apenas a configuração do Claude Desktop. Após instalar, registre o servidor:

npx scrivener-setup

Isso detecta o Claude Code (junto com Claude Desktop e Cursor) e grava a configuração para você. Para registrar manualmente:

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

Em seguida, reinicie o Claude Code (ou execute /mcp para reconectar) e o Scrivener MCP aparecerá na lista de servidores. Remova -s user para limitá-lo ao projeto atual em vez de todos os projetos.

Smithery

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

npx (sem instalação)

Use diretamente sem instalar globalmente:

npx scrivener-mcp

Ou adicione manualmente à configuração do Claude Desktop:

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

GitHub

Instale diretamente do repositório (main mais recente):

npm install -g writerslogic/scrivener-mcp

Ou uma versão 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-..."

O que você pode fazer

Primeiro, abra um projeto. O servidor age sobre qualquer projeto .scriv para o qual você o apontar -- ele não tem vínculo com o aplicativo Scrivener e não consegue ver o que você tem aberto lá. Comece uma conversa com "Abra meu projeto Scrivener em ~/Documents/My Novel.scriv" (ou "Descubra meus projetos Scrivener" se você não souber o caminho) e então dê seus comandos. No macOS, você também pode simplesmente dizer "Use o projeto que tenho aberto no Scrivener" -- ele detecta o projeto aberto e o abre (na primeira vez, o macOS pede que você permita controlar o Scrivener). Faça isso uma vez no início de cada conversa; os exemplos abaixo pressupõem que um projeto esteja aberto. Se o mesmo projeto também estiver aberto e não salvo no aplicativo Scrivener, salve-o ou feche-o lá primeiro para evitar gravações conflitantes.

Gerencie seu manuscrito

Abra qualquer projeto Scrivener e trabalhe com ele naturalmente. Leia capítulos, crie novas cenas, reorganize o binder, atualize sinopses -- tudo por meio de conversa.

Você: Crie uma nova cena chamada "The Reveal" após o Capítulo 5 e mova o epílogo antigo para a lixeira.

Analise sua escrita

Obtenha feedback detalhado sobre legibilidade, ritmo, estilo, qualidade do diálogo e arco emocional. Não é um conselho genérico -- é uma análise baseada na sua prosa real.

Você: Analise o Capítulo 3. O ritmo está lento demais?

Claude: A legibilidade está boa (nota Flesch-Kincaid 8,2), mas o ritmo apresenta alertas:

• 4 parágrafos consecutivos de monólogo interno (linhas 45-78) sem ação ou diálogo
• A cena tem 3.200 palavras com apenas 2 quebras de cena -- seus outros capítulos têm em média 4
• A densidade de palavras de filtro é 2x a média do seu manuscrito ("sentiu", "parecia", "notou") Sugestões específicas: ...

Aprimore sua prosa

Aplique melhorias direcionadas: elimine palavras de filtro, fortaleça verbos, varie a estrutura das frases, adicione detalhes sensoriais, converta narração em mostração, aperte o diálogo, ajuste o ritmo.

Você: Elimine as palavras de filtro no Capítulo 7 e fortaleça os verbos.

Acompanhe personagens e enredo

Armazene perfis de personagens, linhas de enredo e guias de estilo que persistem com seu projeto. A IA lembra de seus personagens entre sessões.

Você: Salve um perfil de personagem para Marcus: detetive aposentado, cínico mas justo, anda com uma claudicação de uma lesão antiga, fala em frases curtas e secas.

Mais tarde...

Você: Verifique se Marcus é consistente em todos os capítulos.

Claude: Encontrei uma inconsistência: Marcus anda "rapidamente" no Capítulo 9 (linha 34), mas a claudicação dele é mencionada nos Capítulos 2, 5 e 11. Além disso, o diálogo dele no Capítulo 4 usa frases longas e fluidas, o que contradiz a nota de "frases curtas e secas" no perfil dele.

Pesquise por significado

Encontre passagens pelo que elas significam, não apenas por correspondência de palavras-chave. "Encontre cenas em que o protagonista se sente isolado" funciona mesmo que a palavra "isolado" nunca apareça. O índice do projeto e a pontuação de similaridade são executados localmente pelo Sistema de Memória Holográfica; o pipeline de pesquisa atual também usa seu provedor de IA configurado para interpretação de consultas e explicação de resultados, portanto semantic_search requer um provedor.

Você: Encontre todas as cenas em que Elena e Marcus estão sozinhos juntos.

Acompanhe relacionamentos

Armazene e consulte relacionamentos entre personagens, locais, temas e linhas de enredo. Não é necessário Neo4j -- os relacionamentos vivem no mecanismo de memória semântica e persistem com seu projeto.

Você: Quem está conectado a Marcus? Quais linhas de enredo envolvem o farol?

Compile e exporte

Combine capítulos em um único manuscrito com formatação configurável, separadores e preservação da estrutura. Exporte o resultado inline como Markdown, HTML ou JSON, ou grave um arquivo DOCX, EPUB ou PDF em disco para submissão, e-readers ou impressão.

Todas as ferramentas

57 ferramentas organizadas por fluxo de trabalho. Para manter o uso de tokens baixo, as ferramentas são carregadas progressivamente -- ferramentas de projeto na inicialização, ferramentas de documento e pesquisa quando você abre um projeto, e o restante sob demanda (seu cliente de IA as ativa automaticamente, ou as chama diretamente e a skill proprietária é ativada em tempo real). Defina SCRIVENER_MCP_EAGER_TOOLS=1 para carregar tudo de uma vez.

Guias

• Começando -- Instalação, configuração, sua primeira sessão
• Configuração do Cliente MCP -- Configuração copiar-e-colar para Claude Desktop, Claude Code, Cursor e VS Code
• Escrevendo com IA -- Fluxos de análise, estratégias de aprimoramento, gerenciamento de memória
• Solução de Problemas -- Problemas comuns e correções
• Otimização de Tokens -- Como o servidor minimiza o uso da janela de contexto
• Arquitetura -- Como o servidor funciona, estrutura de módulos, fluxo de dados
• Compatibilidade com Scrivener -- Versões suportadas do Scrivener, plataformas e cobertura de formatos
• Formato de Arquivo do Scrivener -- O formato .scriv de engenharia reversa, o que lemos vs. inferimos, e orientações de modificação segura
• Fuzzing -- Alvo Jazzer.js e detalhes de integração com OSS-Fuzz
• Contribuindo -- Configuração de desenvolvimento, convenções de código, adição de novas ferramentas

Requisitos

• Node.js 18+
• Arquivos de projeto do Scrivener 3 (.scriv)
• macOS, Windows ou Linux
• Opcional: chave de API Anthropic, OpenAI ou OpenRouter para recursos de IA baseados em provedor
• Opcional: Neo4j para persistência e consultas avançadas de grafos; as ferramentas principais de relacionamento funcionam sem ele

Desenvolvimento

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 que Este?

Vários servidores MCP para Scrivener existem. Esta comparação é baseada na documentação pública de cada projeto, pacote publicado e superfície de ferramentas anunciada em 2026-08-07. "Não" significa que o projeto não documenta essa capacidade; não afirma que a capacidade é impossível através do cliente de IA conectado.

Contagens e afirmações de recursos podem mudar. Siga os projetos vinculados para sua documentação mais recente; a fonte de comparação mantida é docs/comparison.yml.

Contribuindo

Aceitamos contribuições de todos os tamanhos. Consulte o rastreador de problemas para obter as etiquetas good first issue, ou veja o guia de contribuição para a configuração de desenvolvimento.

Áreas onde a ajuda é especialmente bem-vinda:

• Cobertura de testes (#18)
• Testes no Windows e tratamento de caminhos
• Testes de compatibilidade com Scrivener 2
• Melhorias na documentação (#25)

Segurança

Encontrou uma vulnerabilidade? Por favor, reporte-a de forma privada -- veja SECURITY.md.

Licença

AGPL-3.0 © WritersLogic, Inc.

Gratuito para uso pessoal e projetos de código aberto. Licença comercial disponível para integração proprietária. Veja COMMERCIAL_LICENSE.md para detalhes.

GitHub · npm · Issues · Changelog