📚 MCP StyledBook

Um Model Context Protocol (MCP) para criação de ebooks estilizados com pesquisa profunda, linguagem visceral e formatação visual impactante.

🔥 O que é isso?

StyledBook é um MCP (Model Context Protocol) que capacita modelos de linguagem a criar ebooks completos. O protocolo fornece todas as ferramentas necessárias para:

1. Pesquisar profundamente qualquer tema
2. Transformar o conteúdo em uma abordagem visceral e provocativa
3. Estruturar capítulos com lógica, intensidade e coerência
4. Escrever cada capítulo em arquivos separados
5. Unir tudo em um único documento
6. Estilizar com formatação visual impactante
7. Gerar um PDF final profissional

🚀 Recursos

• Interface MCP compatível com Cursor, Trae, Windsurf e outras ferramentas
• Geração de ebooks estruturados com sumário e capítulos
• Conversão de conteúdo técnico em linguagem visceral e provocativa
• Estilização visual personalizada para diferentes tipos de conteúdo
• Suporte para transporte HTTP e STDIO conforme o Model Context Protocol

🛠️ Instalação

Instalação global via NPM

# Instalação global via NPM (recomendado)
npm install -g mcp-styledbook

Instalação via clone do repositório

# Ou clone o repositório
git clone https://github.com/olucianobotelho/mcp-styledbook.git
cd mcp-styledbook
npm install

🚀 Uso

Via linha de comando global:

# Iniciar o servidor MCP na porta padrão (3001) com transporte HTTP
mcp-styledbook

# Iniciar em uma porta específica
mcp-styledbook --port=3005

# Iniciar usando transporte stdio (para uso com Cursor, Trae, etc)
mcp-styledbook --transport=stdio

# Mostrar ajuda
mcp-styledbook --help

Usando NPX:

Se não quiser instalar globalmente, você pode usar npx:

# Usando o npx (não requer instalação)
npx mcp-styledbook
npx mcp-styledbook --port=3005
npx mcp-styledbook --transport=stdio

Como dependência em seu projeto:

const mcpStyledBook = require('mcp-styledbook');

// Tudo pronto! O servidor MCP será inicializado automaticamente
// O resto será tratado pelo Model Context Protocol

🔌 Configuração nas Ferramentas de IA

Modo HTTP (Recomendado para testes)

Quando você executa o MCP StyledBook no modo HTTP (padrão), você pode configurá-lo no Cursor:

Cursor

1. Abra o Cursor
2. Vá em Configurações > Features > MCP Servers
3. Adicione um novo servidor HTTP
4. Preencha com a URL: http://localhost:3001/mcp (ou outra porta se especificada)

Trae

1. Abra o Trae
2. Vá em Configurações > MCP
3. Adicione a URL: http://localhost:3001/mcp

Windsurf

1. Abra o Windsurf
2. Vá em Configurações > MCP
3. Adicione a URL: http://localhost:3001/mcp

Modo STDIO (Recomendado para uso diário)

Para configurar usando o modo STDIO (mais seguro e recomendado para uso diário), você precisa criar ou editar o arquivo de configuração MCP.

Onde encontrar/criar o arquivo de configuração:

• Global (para todos os projetos): ~/.cursor/mcp.json
• Por projeto: .cursor/mcp.json na raiz do seu projeto

Adicione a seguinte configuração:

{
  "mcpServers": {
    "styledbook": {
      "command": "npx",
      "args": ["-y", "mcp-styledbook", "--transport=stdio"]
    }
  }
}

📦 Configuração JSON (.cursor/mcp.json)

Você pode usar estas configurações no arquivo .cursor/mcp.json ou ~/.cursor/mcp.json:

Para HTTP (por projeto):

{
  "mcpServers": {
    "styledbook": {
      "url": "http://localhost:3001/mcp"
    }
  }
}

Para STDIO (recomendado):

{
  "mcpServers": {
    "styledbook": {
      "command": "npx",
      "args": ["-y", "mcp-styledbook", "--transport=stdio"]
    }
  }
}

🧪 Testes

Para testar o servidor MCP, você pode usar um dos scripts fornecidos:

No Windows

.\testar_api.bat

No Linux/Mac

chmod +x testar_api.sh
./testar_api.sh

Estes scripts executarão cada uma das ferramentas do MCP em sequência e mostrarão os resultados.

🧰 Ferramentas disponíveis

O MCP StyledBook fornece as seguintes ferramentas:

| Ferramenta | Descrição | |------------|-----------| | configurar_parametros_ebook | Configura parâmetros básicos para criação do ebook | | pesquisar_tema | Realiza pesquisa profunda sobre o tema | | criar_planejamento | Transforma conteúdo em planejamento visceral | | criar_sumario | Cria sumário estruturado do ebook | | escrever_capitulo | Escreve um capítulo em arquivo separado | | unir_capitulos | Une todos os capítulos em um único arquivo | | estilizar_ebook | Aplica formatação visual ao ebook final |

📂 Estrutura de Arquivos

ebook/
└── [tema]/
    ├── config.json           # Configuração do ebook
    ├── sumario.md            # Sumário do livro
    ├── ebookcompleto.md      # Arquivo unificado
    ├── ebook_final.pdf       # PDF estilizado
    └── capitulos/
        ├── capitulo_1.md     # Capítulo 1
        ├── capitulo_2.md     # Capítulo 2
        └── ...

📱 Exemplo de Uso com Diferentes LLMs

O MCP StyledBook foi projetado para funcionar com diferentes modelos de linguagem:

• Claude 3.7 (Recomendado): Melhor compreensão das instruções e geração de conteúdo criativo
• GPT-4o: Boa alternativa, especialmente para conteúdo técnico
• Claude 3 Opus: Excelente para conteúdo longo e detalhado
• Claude 3 Sonnet: Bom equilíbrio entre velocidade e qualidade

📝 Exemplo de Prompt para Claude

Usando as ferramentas do MCP StyledBook, crie um livro curto sobre "Jardins Verticais" com estilo visceral, 3 capítulos, focando na revolução urbana que essas estruturas representam.

🔍 Solução de Problemas

Problema: Não consigo ver o MCP no Cursor/Trae/Windsurf

Solução:

• Verifique se o servidor está rodando (mcp-styledbook)
• Confirme se a URL está correta no modo HTTP (http://localhost:3001/mcp)
• Verifique sua configuração no arquivo mcp.json
• Reinicie a ferramenta (Cursor/Trae/Windsurf) após adicionar o MCP

Problema: Porta já em uso

Solução:

• Use uma porta diferente: mcp-styledbook --port=3002

Problema: O MCP não responde no modo STDIO

Solução:

• Verifique se tem a versão mais recente: npm update -g mcp-styledbook
• Use o modo HTTP para debugging: mcp-styledbook --transport=http

👨‍💻 Contribuição

Contribuições são bem-vindas! Por favor, sinta-se à vontade para enviar um Pull Request.

📄 Licença

MIT