mcp-styledbook/README.md

Model Context Protocol para criação de ebooks estilizados com pesquisa profunda e formatação visual impactante

# 📚 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

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

### Instalação via clone do repositório

```bash
# 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:

```bash
# 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:

```bash
# 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:

```javascript
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:

```json
{
  "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):

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

### Para STDIO (recomendado):

```json
{
  "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
```bash
.\testar_api.bat
```

### No Linux/Mac
```bash
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