{
  "markdown": "# PDF Modifier MCP\n\n**CLI + MCP server + Web UI** for PDF text replacement with font style preservation.\n\n[![CI](https://github.com/mlorentedev/pdf-modifier-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/mlorentedev/pdf-modifier-mcp/actions/workflows/ci.yml)\n[![PyPI](https://img.shields.io/pypi/v/pdf-modifier-mcp)](https://pypi.org/project/pdf-modifier-mcp/)\n[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)\n[![Docs](https://img.shields.io/badge/docs-live-blue.svg)](https://mlorentedev.github.io/pdf-modifier-mcp/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n## Quick start\n\n```bash\npip install pdf-modifier-mcp\n\n# CLI\npdf-mod modify input.pdf output.pdf -r \"Draft=Final\"\n\n# MCP server (for Claude/Cursor/Codex)\nclaude mcp add -s user pdf-modifier -- uvx pdf-modifier-mcp\n```\n\n## Interfaces\n\n| Interface | Description | Run |\n|-----------|-------------|-----|\n| **CLI** | `pdf-mod` — batch jobs, scripting, CI pipelines | `make run cli ARGS=\"...\"` |\n| **MCP Server** | `pdf-modifier-mcp` — AI agents edit PDFs | `make run mcp` |\n| **Web UI** | FastAPI + SvelteKit — drag & drop, preview, replace | `make up` (Docker) or `make run api` + `make run frontend` |\n\n## Features\n\n- **Text replacement** — find and replace with font style preservation (family, weight, size, color)\n- **Regex support** — pattern-based bulk replacements (`--regex`)\n- **Hyperlinks** — create clickable links or neutralize existing ones\n- **Batch processing** — apply same replacements to multiple files\n- **Web UI** — drag & drop PDF upload, structure browser, page preview with zoom, text highlighting\n- **MCP tools** — `read_pdf_structure`, `inspect_pdf_fonts`, `list_pdf_hyperlinks`, `modify_pdf_content`\n\n## Development\n\n```bash\n# Setup\nmake setup\n\n# Run tests\nmake test\n\n# Full check (lint + type + test)\nmake check\n\n# Start dev stack (Docker)\nmake up\n# API: http://localhost:8000 | Web: http://localhost:8080\n\n# Start servers locally\nmake run api          # FastAPI dev server\nmake run frontend     # SvelteKit dev server\n```\n\n## Documentation\n\n- [Full documentation site](https://mlorentedev.github.io/pdf-modifier-mcp/)\n- [Architecture Decision Records](docs/adr/)\n- [Troubleshooting](docs/troubleshooting/)\n- [Lessons learned](docs/lessons.md)\n\n## License\n\nMIT",
  "bytes": 2380,
  "sha": "b7ceb38cbf3decbaf1bcf973096e701554f1c813742c7ec9d83a39338dd2b0a1",
  "repo_slug": "mlorentedev/pdf-modifier-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_mlorentedev_pdf_modifier_mcp_03cfa25f/readme"
}