autoform-mcp-server 1.2.0 → 1.3.0

package/README.md

@@ -123,9 +123,23 @@ When a template has repeated fields (e.g., 3 fields named "nombre"):
 - **`sequential`** (default): Each field consumes a different data row. 9 rows + 3 fields = 3 documents.
 - **`repeat`**: One row fills ALL fields with the same name. 9 rows = 9 documents.
 
+## Storage
+
+All data is stored in `~/.autoform-mcp/` on the user's machine:
+
+```
+~/.autoform-mcp/
+├── templates/    ← Saved templates (JSON + PDF files)
+└── output/       ← Generated PDFs
+```
+
+- **Windows:** `C:\Users\<name>\.autoform-mcp\`
+- **macOS/Linux:** `~/.autoform-mcp/`
+
+You can override the output path in any tool using the `output_path` or `output_dir` parameter.
+
 ## How It Works
 
-- Templates and generated PDFs are stored locally in the MCP server directory
 - Uses `pdf-lib` for PDF manipulation (no external services)
 - All processing happens locally — no data leaves your machine
 - Zero vulnerabilities — only 3 dependencies

package/dist/services/batchGenerator.js

@@ -1,7 +1,9 @@
 import * as fs from 'fs';
 import * as path from 'path';
 import { PdfService } from './pdfService.js';
-const OUTPUT_DIR = path.resolve(import.meta.dirname, '../../output');
+import * as os from 'os';
+const AUTOFORM_HOME = path.join(os.homedir(), '.autoform-mcp');
+const OUTPUT_DIR = path.join(AUTOFORM_HOME, 'output');
 /**
  * Batch PDF generation with distribution logic.
  * Adapts web app's distributionEngine + pdfGenerator for Node.js.
@@ -21,11 +23,15 @@ export class BatchGenerator {
         }
         const outputPaths = [];
         const errors = [];
+        // If merging, write individuals to temp dir (will be cleaned up)
+        const workingDir = mergeIntoSingle
+            ? fs.mkdtempSync(path.join(OUTPUT_DIR, '.tmp_batch_'))
+            : OUTPUT_DIR;
         for (let docNum = 0; docNum < documentsNeeded; docNum++) {
             try {
                 const mappings = this.createMappings(data, template, docNum, mode);
                 const docNumStr = String(docNum + 1).padStart(3, '0');
-                const outputPath = path.join(OUTPUT_DIR, `${safeName}_${docNumStr}_${timestamp}.pdf`);
+                const outputPath = path.join(workingDir, `${safeName}_${docNumStr}_${timestamp}.pdf`);
                 await PdfService.generateSingleDocument(basePdf, mappings, outputPath);
                 outputPaths.push(outputPath);
             }
@@ -33,11 +39,28 @@ export class BatchGenerator {
                 errors.push(`Doc ${docNum + 1}: ${err instanceof Error ? err.message : String(err)}`);
             }
         }
-        // Merge if requested
+        // Merge if requested — and clean up individuals
         let mergedPath;
         if (mergeIntoSingle && outputPaths.length > 0) {
             mergedPath = path.join(OUTPUT_DIR, `${safeName}_merged_${timestamp}.pdf`);
             await PdfService.mergePdfs(outputPaths, mergedPath);
+            // Delete temp files and dir
+            for (const p of outputPaths) {
+                try {
+                    fs.unlinkSync(p);
+                }
+                catch { /* ignore */ }
+            }
+            try {
+                fs.rmdirSync(workingDir);
+            }
+            catch { /* ignore */ }
+            return {
+                documentsGenerated: outputPaths.length,
+                outputPaths: [],
+                mergedPath,
+                errors
+            };
         }
         return {
             documentsGenerated: outputPaths.length,

package/dist/services/pdfService.js

@@ -202,11 +202,14 @@ export class PdfService {
      * Each entry in `dataRows` produces one PDF using the same field positions.
      */
     static async batchFillAtCoordinates(pdfPath, fieldDefinitions, dataRows, outputDir, baseName, merge = false) {
-        const bytes = fs.readFileSync(pdfPath);
         const outputPaths = [];
         const errors = [];
         const timestamp = new Date().toISOString().slice(0, 10);
         fs.mkdirSync(outputDir, { recursive: true });
+        // If merging, write individuals to a temp dir that will be cleaned up
+        const workingDir = merge
+            ? fs.mkdtempSync(path.join(outputDir, '.tmp_batch_'))
+            : outputDir;
         for (let i = 0; i < dataRows.length; i++) {
             try {
                 const row = dataRows[i];
@@ -221,7 +224,7 @@ export class PdfService {
                     overflowMode: def.overflowMode
                 })).filter(f => f.text.trim() !== '');
                 const num = String(i + 1).padStart(3, '0');
-                const outPath = path.join(outputDir, `${baseName}_${num}_${timestamp}.pdf`);
+                const outPath = path.join(workingDir, `${baseName}_${num}_${timestamp}.pdf`);
                 await this.fillAtCoordinates(pdfPath, fields, outPath);
                 outputPaths.push(outPath);
             }
@@ -233,6 +236,19 @@ export class PdfService {
         if (merge && outputPaths.length > 0) {
             mergedPath = path.join(outputDir, `${baseName}_merged_${timestamp}.pdf`);
             await this.mergePdfs(outputPaths, mergedPath);
+            // Clean up temp files and dir
+            for (const p of outputPaths) {
+                try {
+                    fs.unlinkSync(p);
+                }
+                catch { /* ignore */ }
+            }
+            try {
+                fs.rmdirSync(workingDir);
+            }
+            catch { /* ignore */ }
+            // Clear individual paths from response since they no longer exist
+            return { outputPaths: [], mergedPath, errors };
         }
         return { outputPaths, mergedPath, errors };
     }

package/dist/services/templateStore.js

@@ -1,6 +1,8 @@
 import * as fs from 'fs';
 import * as path from 'path';
-const TEMPLATES_DIR = path.resolve(import.meta.dirname, '../../templates');
+import * as os from 'os';
+const AUTOFORM_HOME = path.join(os.homedir(), '.autoform-mcp');
+const TEMPLATES_DIR = path.join(AUTOFORM_HOME, 'templates');
 /**
  * Filesystem-based template storage.
  * Templates are stored as individual JSON files in the templates/ directory.

package/dist/tools/fillAtCoordinates.js

@@ -1,11 +1,18 @@
 import * as path from 'path';
+import * as os from 'os';
 import { PdfService } from '../services/pdfService.js';
-const OUTPUT_DIR = path.resolve(import.meta.dirname, '../../output');
+const OUTPUT_DIR = path.join(os.homedir(), '.autoform-mcp', 'output');
 export const fillAtCoordinatesSchema = {
     name: 'autoform_fill_at_coordinates',
     description: `Escribe texto en posiciones exactas de un PDF usando coordenadas en puntos PDF (origen: esquina inferior-izquierda).
 Ideal cuando Claude analiza visualmente un PDF y determina dónde colocar el texto.
 
+IMPORTANTE — Codificación de texto:
+- El texto se pasa EXACTAMENTE como lo envías. NO simplifiques ni modifiques caracteres.
+- Acentos españoles (á é í ó ú ñ Ñ ü) están soportados completamente.
+- Nombres como "Sofía", "Benítez", "Peña" deben pasarse con sus tildes intactas.
+- Solo se filtran: emojis, caracteres de control invisibles, y patrones de script malicioso.
+
 FLUJO RECOMENDADO:
 1. Primero usa autoform_get_pdf_info para obtener las dimensiones de cada página
 2. Basándote en el análisis visual del PDF, calcula las coordenadas en puntos PDF
@@ -44,7 +51,7 @@ SISTEMA DE COORDENADAS:
             },
             output_path: {
                 type: 'string',
-                description: '(Opcional) Ruta donde guardar el PDF. Si no se especifica, se guarda en output/'
+                description: '(Opcional) Ruta donde guardar el PDF. Default: ~/.autoform-mcp/output/'
             }
         },
         required: ['pdf_path', 'fields']

package/dist/tools/fillBatchAtCoordinates.js

@@ -1,12 +1,20 @@
 import * as path from 'path';
+import * as os from 'os';
 import { PdfService } from '../services/pdfService.js';
-const OUTPUT_DIR = path.resolve(import.meta.dirname, '../../output');
+const OUTPUT_DIR = path.join(os.homedir(), '.autoform-mcp', 'output');
 export const fillBatchAtCoordinatesSchema = {
     name: 'autoform_fill_batch_at_coordinates',
     description: `Genera MULTIPLES PDFs a partir de un mismo PDF base, escribiendo datos diferentes en las mismas posiciones de cada copia.
 
 CUANDO USAR: El usuario pasa un PDF (certificado, diploma, constancia) y una LISTA de datos (nombres, fechas, etc.) y quiere generar un PDF por cada fila de datos.
 
+IMPORTANTE — Codificación de texto:
+- Los datos se escriben EXACTAMENTE como los envías. NO simplifiques ni modifiques caracteres.
+- Acentos españoles (á é í ó ú ñ Ñ ü) están soportados completamente.
+- Nombres como "Sofía", "Benítez", "Peña" deben pasarse con sus tildes intactas.
+
+MERGE: Si merge_into_single=true, se genera SOLO el PDF unificado (los individuales son temporales y se borran automáticamente).
+
 FLUJO:
 1. Usa autoform_get_pdf_info para obtener las dimensiones de la pagina
 2. Analiza visualmente el PDF para determinar donde van los campos
@@ -54,7 +62,7 @@ SISTEMA DE COORDENADAS: Origen (0,0) = esquina inferior-izquierda. Y aumenta hac
             },
             output_dir: {
                 type: 'string',
-                description: '(Opcional) Directorio de salida. Default: output/'
+                description: '(Opcional) Directorio de salida. Default: ~/.autoform-mcp/output/'
             }
         },
         required: ['pdf_path', 'field_definitions', 'data_rows']

package/dist/tools/fillPdf.js

@@ -1,7 +1,8 @@
 import * as path from 'path';
+import * as os from 'os';
 import { PdfService } from '../services/pdfService.js';
 import { TemplateStore } from '../services/templateStore.js';
-const OUTPUT_DIR = path.resolve(import.meta.dirname, '../../output');
+const OUTPUT_DIR = path.join(os.homedir(), '.autoform-mcp', 'output');
 export const fillPdfSchema = {
     name: 'autoform_fill_pdf',
     description: `Llena UN PDF con valores. Detecta automaticamente si tiene AcroForm o usa un template guardado.
@@ -23,7 +24,7 @@ NO USAR SI: Quieres generar MULTIPLES documentos → usa autoform_generate_batch
             },
             output_path: {
                 type: 'string',
-                description: '(Opcional) Ruta donde guardar el PDF llenado. Si no se especifica, se guarda en la carpeta output/'
+                description: '(Opcional) Ruta donde guardar el PDF llenado. Default: ~/.autoform-mcp/output/'
             },
             template_name: {
                 type: 'string',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autoform-mcp-server",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "MCP server for bulk PDF form filling. Detect fields, fill templates, and generate hundreds of PDFs from data — directly from Claude.",
   "type": "module",
   "main": "dist/index.js",
@@ -36,8 +36,6 @@
   },
   "files": [
     "dist",
-    "templates/.gitkeep",
-    "output/.gitkeep",
     "README.md"
   ],
   "dependencies": {