Fizzdoc MCP

Ferramentas locais de PDF, áudio e Office para agentes de IA: mesclar, dividir, girar, proteger e desbloquear PDFs, cortar e unir MP3/M4A sem reencodificação, remover metadados de documentos. Os arquivos nunca saem da sua máquina.

GitHub

Documentação

Servidor Fizzdoc MCP

Ferramentas de PDF, áudio e Office da Fizzdoc para agentes de IA — seus arquivos nunca saem do seu computador.

Peça ao Claude Code, Codex, Claude Desktop, Cursor ou qualquer outro cliente MCP para "mesclar estes PDFs", "cortar os primeiros 30 segundos deste MP3" ou "remover o nome do autor antes de eu enviar isto". O agente chama o Fizzdoc na sua máquina em vez de enviar seu arquivo para um site ou escrever um script descartável.

Somente local. Os arquivos são lidos do disco e novos arquivos são gravados ao lado deles. Sem rede, sem telemetria, sem conta.
Nunca sobrescreve. Um nome existente recebe um novo arquivo como report (2).pdf.
Mesmos mecanismos do fizzdoc.com. O qpdf mantém formulários, links e marcadores; o áudio é cortado e unido sem re-encodificação.

⭐ Se o Fizzdoc ajudar você, por favor dê uma estrela no GitHub — é gratuito, e as estrelas ajudam outras pessoas a encontrá-lo.

Ferramentas

Ferramenta	O que faz
`merge_pdf`	Combina PDFs na ordem fornecida
`split_pdf`	Um arquivo por intervalo de páginas, ou a cada N páginas
`extract_pdf_pages`	Salva as páginas escolhidas como um novo PDF, na ordem digitada
`reorder_pdf_pages`	Reorganiza páginas, ex.: `3, 1-2, 4-`
`delete_pdf_pages`	Remove páginas
`rotate_pdf`	Gira todas ou algumas páginas em 90°, 180° ou 270°
`protect_pdf` / `unlock_pdf`	Adiciona ou remove uma senha (AES-256)
`remove_pdf_metadata`	Remove autor, título, aplicativo criador e dados XMP
`pdf_info`	Contagem de páginas e tamanho
`trim_audio`	Mantém uma parte de um MP3 ou M4A
`split_audio`	Corta um MP3 ou M4A em partes em horários determinados
`merge_audio`	Une arquivos MP3, ou arquivos M4A, em um só
`audio_info`	Formato, duração, taxa de amostragem, canais
`clean_office`	Remove autor, editor, empresa e título de um .docx, .xlsx ou .pptx

Intervalos de páginas parecem com 1-3, 8 (um - final significa "até o fim"). Horários parecem com 1:30, 90 ou 1:02:03.5.

Configuração

Você precisa de Node.js 20 ou mais recente.

Claude Code

claude mcp add fizzdoc -- npx -y fizzdoc-mcp

No Windows, o npx precisa ser iniciado por meio do cmd:

claude mcp add fizzdoc -- cmd /c npx -y fizzdoc-mcp

Codex CLI

Adicione ao ~/.codex/config.toml:

[mcp_servers.fizzdoc]
command = "npx"
args = ["-y", "fizzdoc-mcp"]

Claude Desktop, Cursor, VS Code e outros

Adicione isto às configurações de MCP do cliente (claude_desktop_config.json, .cursor/mcp.json, …):

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

A partir do código-fonte

git clone https://github.com/kingrishabdugar/fizzdoc.git
cd fizzdoc
npm install
npm run build:mcp

Em seguida, use node /path/to/fizzdoc/mcp/dist/server.js como o comando em qualquer uma das configurações acima.

Desenvolvimento

As ferramentas estão em src/tools.ts e chamam os mesmos mecanismos do site (../src/engine). src/server.ts as descreve para agentes. Testes em ../tests/mcp.test.ts executam cada ferramenta sobre o protocolo real e verificam os arquivos que ela grava:

npx vitest run tests/mcp.test.ts

Mais ferramentas (compactar, converter, OCR, redigir) estão por vir: veja #61 e as outras issues em #57. Contribuições são bem-vindas.