Numerador de facturas

io.github.nuncaeslupusPublished by GitHub account nuncaeslupusv0.1.1Updated Nov 1, 2026

Number batches of PDF invoices offline: stamps F-0001, F-0002… on a local copy of each.

VerifiedSTDIODesktop onlyProductivity & WorkflowFiles & Storage

Overview

AI-generated overview

Local MCP server that stamps sequential numbers like F-0001 on every page of PDF invoices and writes numbered copies, fully offline.

What you can do
  • Number a batch of PDF invoices: stamp a correlative number on every page of each file and write numbered copies to a new folder.
  • Choose numbering options such as template, start or end value, order, position, font, box, merged PDF or ZIP, and preview the result with a dry run before writing.
  • Keep originals untouched: the tool works on copies, refuses to overwrite existing files, and rolls back partial writes.
When to use it
Useful when you need to foliate, number or Bates-stamp a folder of PDF invoices or similar documents and want the assistant to do it locally instead of writing a custom script.
Requirements
Runs as a local stdio process via npx (package numerador-facturas-mcp) or a Claude Desktop bundle; requires Node 20 or higher. No account, API key or network access is needed by the server itself, though npx checks npm for new versions at startup.
Before you install
The assistant passes file and folder paths, not PDF contents, and only receives the list of generated files; if you ask it to read an invoice, that content goes to your LLM provider. Protected PDFs cause the whole batch to be skipped, and copies of protected PDFs are produced without a password. Structural checks may miss damage inside page content, and the tool does not verify that a number fits entirely on the page.

Installation

In SourceWeft

  1. Open Numerador de facturas in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

numerador-facturas-mcp

Servidor MCP para que un LLM numere facturas PDF en lote: estampa F-0001, F-0002… en todas las páginas de cada factura y escribe copias numeradas.

Es el mismo código que la web, sin UI.

Privado y sin red. Se ejecuta en tu equipo como proceso local. El LLM le pasa rutas, no el contenido de los PDFs, y solo recibe la lista de archivos generados. No necesita cuenta ni conexión, y los originales no se modifican. Si le pides al LLM que lea una factura, ese contenido sí pasa por tu proveedor de LLM.

Instalar

Claude Desktop: descarga numerador-facturas.mcpb y ábrelo.

Claude Code:

bash
claude mcp add --scope user numerador-facturas -- npx -y numerador-facturas-mcp

Otros clientes MCP:

json
{  "mcpServers": {    "numerador-facturas": { "command": "npx", "args": ["-y", "numerador-facturas-mcp"] }  }}

Requiere Node 20 o superior. El servidor no tiene dependencias en tiempo de ejecución y no hace peticiones de red. npx sí consulta npm al arrancar para buscar versiones nuevas, sin enviar nada de tus facturas; si no quieres ni eso, usa el .mcpb.

Usar

Pídelo con normalidad: «numera las facturas de esta carpeta desde la F-0500».

La herramienta number_invoices acepta las mismas opciones que la web (plantilla, inicio o fin, orden, posición, fuente, recuadro, PDF unido, ZIP), más dry_run para ver la numeración sin escribir nada.

A diferencia de la web, si un archivo está protegido, o detecta que está dañado o incompleto, no numera ninguno, para no dejar huecos en la serie. La comprobación mira la estructura del PDF: un daño dentro del contenido de una página puede pasar sin detectarse. Tampoco sobrescribe archivos existentes, y si falla al escribir borra lo que haya escrito. Rechaza una posición que caiga fuera de alguna página, pero no comprueba que el número quepa entero. Las copias de un PDF protegido salen sin contraseña.

Publicar

La versión vive en package.json, manifest.json y server.json, y un test exige que coincidan. La primera vez, desde mcp/ y con sesión en npm:

bash
npm publish --access public

Después configura en npm el trusted publisher (repositorio nuncaeslupus/numerador-facturas, workflow release-mcp.yml). Las siguientes versiones salen al empujar un tag mcp-vX.Y.Z, que publica en npm y en el registro de MCP. La primera no llega al registro por sí sola: empuja también su tag, con la publicación en npm ya hecha. Publica en npm antes de fusionar a main: la web anuncia este nombre de paquete, y hasta entonces cualquiera podría registrarlo.

Licencia

MIT

Source: mcp/README.md at commit 374a40d

Tools

1

number_invoices

Numerar facturas

Stamps a correlative number (F-0001, F-0002…) on every page of each PDF invoice in a batch and writes numbered copies to a new folder. Numera facturas PDF en lote. Runs locally and offline: the PDFs stay on this computer and the originals are not modified.

Parametersendzipfontx_mmy_mmcolormergepathsrequiredstartfrom_xfrom_ydry_run+8 more

Version history

1
  1. v0.1.1LatestOct 31, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts