Fizzdoc MCP
Herramientas locales de PDF, audio y Office para agentes de IA: fusionar, dividir, rotar, proteger y desbloquear PDFs, cortar y unir MP3/M4A sin recodificar, eliminar metadatos de documentos. Los archivos nunca salen de tu máquina.
Documentación
Servidor MCP de Fizzdoc
Herramientas de PDF, audio y Office de Fizzdoc para agentes de IA: tus archivos nunca salen de tu computadora.
Pídele a Claude Code, Codex, Claude Desktop, Cursor o cualquier otro cliente MCP que "combine estos PDFs", "corte los primeros 30 segundos de este MP3" o "elimine el nombre del autor antes de que envíe esto". El agente llama a Fizzdoc en tu máquina en lugar de subir tu archivo a un sitio web o escribir un script desechable.
- Solo local. Los archivos se leen del disco y los nuevos se escriben junto a ellos. Sin red, sin telemetría, sin cuenta.
- Nunca sobrescribe. Un nombre existente recibe un archivo nuevo como
report (2).pdf. - Los mismos motores que fizzdoc.com. qpdf conserva formularios, enlaces y marcadores; el audio se corta y se une sin recodificar.
⭐ Si Fizzdoc te ayuda, por favor dale una estrella en GitHub — es gratis, y las estrellas ayudan a que otras personas lo encuentren.
Herramientas
| Herramienta | Qué hace |
|---|---|
merge_pdf | Combina PDFs en el orden dado |
split_pdf | Un archivo por rango de páginas, o cada N páginas |
extract_pdf_pages | Guarda las páginas elegidas como un nuevo PDF, en el orden escrito |
reorder_pdf_pages | Reordena páginas, p. ej. 3, 1-2, 4- |
delete_pdf_pages | Elimina páginas |
rotate_pdf | Rota todas o algunas páginas 90°, 180° o 270° |
protect_pdf / unlock_pdf | Agrega o elimina una contraseña (AES-256) |
remove_pdf_metadata | Elimina autor, título, aplicación creadora y datos XMP |
pdf_info | Número de páginas y tamaño |
trim_audio | Conserva una parte de un MP3 o M4A |
split_audio | Corta un MP3 o M4A en partes en momentos dados |
merge_audio | Une archivos MP3, o archivos M4A, en uno solo |
audio_info | Formato, duración, frecuencia de muestreo, canales |
clean_office | Elimina autor, editor, empresa y título de un .docx, .xlsx o .pptx |
Los rangos de páginas se ven como 1-3, 8 (un - al final significa "hasta el final"). Los tiempos se ven como 1:30, 90 o 1:02:03.5.
Configuración
Necesitas Node.js 20 o más reciente.
Claude Code
claude mcp add fizzdoc -- npx -y fizzdoc-mcp
En Windows, npx debe iniciarse a través de cmd:
claude mcp add fizzdoc -- cmd /c npx -y fizzdoc-mcp
Codex CLI
Agrega a ~/.codex/config.toml:
[mcp_servers.fizzdoc]
command = "npx"
args = ["-y", "fizzdoc-mcp"]
Claude Desktop, Cursor, VS Code y otros
Agrega esto a la configuración MCP del cliente (claude_desktop_config.json, .cursor/mcp.json, …):
{
"mcpServers": {
"fizzdoc": { "command": "npx", "args": ["-y", "fizzdoc-mcp"] }
}
}
Desde el código fuente
git clone https://github.com/kingrishabdugar/fizzdoc.git
cd fizzdoc
npm install
npm run build:mcp
Luego usa node /path/to/fizzdoc/mcp/dist/server.js como comando en cualquiera de las configuraciones anteriores.
Desarrollo
Las herramientas viven en src/tools.ts y llaman a los mismos motores que el sitio web (../src/engine). src/server.ts las describe para agentes. Las pruebas en ../tests/mcp.test.ts ejecutan cada herramienta sobre el protocolo real y verifican los archivos que escribe:
npx vitest run tests/mcp.test.ts
Más herramientas (comprimir, convertir, OCR, redactar) están por venir: consulta #61 y los otros problemas bajo #57. Las contribuciones son bienvenidas.