{"_id":"pdflince-mcp","_rev":"3-22b75d19dc9ab28b007b3157deb31c8a","name":"pdflince-mcp","dist-tags":{"latest":"1.1.1"},"versions":{"0.0.0-stage":{"name":"pdflince-mcp","version":"0.0.0-stage","_id":"pdflince-mcp@0.0.0-stage","stub":true,"maintainers":[{"name":"gsiesto","email":"guillermosiesto@gmail.com"}],"dist":{"shasum":"ce8ffd3a55ecdf7fe50db69776ed77ae8a50d124","tarball":"https://registry.npmjs.org/pdflince-mcp/-/pdflince-mcp-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-NHYF1inNBhzEBOcQsyca6l66hBYpMPNGTteNgnkuX5JpZSrHxIazgcriulbCjB5nF4UEIjtpLPWi8/o/ljrhVA==","signatures":[{"sig":"MEUCIQCNK0gYAKa64udRHeqcIfwP3ro9/QaVT/cD3Ik5j1+WRAIgYyAoJ69lboF4Nn/QZ+JY4IiTCbPG3QQDh5O8oRd4ETM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":334},"_npmUser":{"name":"gsiesto","email":"guillermosiesto@gmail.com"},"description":"Temporary package placeholder for staged publishing","directories":{}},"1.1.0":{"name":"pdflince-mcp","version":"1.1.0","keywords":["pdf","pdf-tools","privacy","client-side","nextjs","react","pdf-lib","mcp","mcp-server","model-context-protocol","ai-agent","claude-mcp","cursor-mcp","hermes-agent","grok","ollama","deepseek"],"license":"MIT","_id":"pdflince-mcp@1.1.0","maintainers":[{"name":"gsiesto","email":"guillermosiesto@gmail.com"}],"homepage":"https://pdflince.com/en/mcp","bugs":{"url":"https://github.com/GSiesto/PDFLince/issues"},"bin":{"pdflince-mcp":"bin/pdflince-mcp.js"},"dist":{"shasum":"16ccf2b28822c2f4c786bd53c8ed9f4144d2df7c","tarball":"https://registry.npmjs.org/pdflince-mcp/-/pdflince-mcp-1.1.0.tgz","fileCount":4,"integrity":"sha512-X0FnvExQmGmJKln4bryzPGZxvPN14xOfeADfOWKm3dJEFLOL++QCYCpTuGm0pPEjxEeWyer0BmRAFPAAfanDKQ==","signatures":[{"sig":"MEQCIGjdIqiBtpRSKf5UWekr/BnRpAO3ikeMOa3cET2M+TUmAiA+KjT0qSQePjJycfKXEvOWWdqyeDTvDq5c2ghIP4r6+A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQDtcFVx6G7yVPRBNMfhHbuiE6srvLrxREntqJxZarrywAIhAJxgqP+EOD3IjQ/SQgMZ0AJV2BvVk0lVDjdtWzrTohvh","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/pdflince-mcp@1.1.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":2101137},"type":"module","engines":{"bun":">=1.0.0","node":">=18.0.0"},"gitHead":"d70230d3cef119740de0b6fc4280371bc6e7e74e","scripts":{"dev":"cross-env STRICT_LINT=true next dev --turbo","lint":"cross-env STRICT_LINT=true next lint","build":"next build","start":"bunx serve out --single","prepack":"bun run build:mcp","prepare":"node scripts/setup-pdf-worker.mjs","preview":"bun run build && bunx serve out --single","lint:fix":"cross-env STRICT_LINT=true next lint --fix","test:e2e":"playwright test","test:mcp":"bun test tests/mcp","build:mcp":"bun build ./src/mcp/index.ts --target node --outfile ./bin/pdflince-mcp.js"},"_npmUser":{"name":"gsiesto","email":"guillermosiesto@gmail.com"},"repository":{"url":"git+https://github.com/GSiesto/PDFLince.git","type":"git"},"_npmVersion":"10.8.2","description":"Privacy-first client-side PDF toolkit and local Model Context Protocol (MCP) server.","directories":{},"_nodeVersion":"20.20.2","dependencies":{"zod":"^4.6.5","next":"^15.5.12","geist":"^1.3.0","react":"^18.3.1","pdf-lib":"^1.17.1","react-dom":"^18.3.0","pdfjs-dist":"^5.4.296","server-only":"^0.0.1","lucide-react":"^0.563.0","@modelcontextprotocol/sdk":"^1.32.1"},"_hasShrinkwrap":false,"devDependencies":{"jszip":"^3.10.1","serve":"^14.2.1","eslint":"^8.57.0","postcss":"^8.5.3","prettier":"^3.3.2","cross-env":"^7.0.3","typescript":"^5.5.3","@types/node":"^20.14.10","tailwindcss":"^3.4.17","@types/jszip":"^3.4.0","@types/react":"^18.3.3","autoprefixer":"^10.4.21","@types/eslint":"^8.56.10","@playwright/test":"^1.58.2","@types/react-dom":"^18.3.0","eslint-config-next":"^15.0.1","@tailwindcss/typography":"^0.5.16","@typescript-eslint/parser":"^8.1.0","prettier-plugin-tailwindcss":"^0.6.5","@typescript-eslint/eslint-plugin":"^8.1.0"},"_npmOperationalInternal":{"tmp":"tmp/pdflince-mcp_1.1.0_1792314191485_0.060776304085214505","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"_id":"pdflince-mcp@1.1.1","bin":{"pdflince-mcp":"bin/pdflince-mcp.js"},"bugs":{"url":"https://github.com/GSiesto/PDFLince/issues"},"dist":{"shasum":"6b0a6223345fccff12d7b9d19d532c06d72c44df","tarball":"https://registry.npmjs.org/pdflince-mcp/-/pdflince-mcp-1.1.1.tgz","fileCount":4,"integrity":"sha512-hqM72Vl9eTEyIG9EKwu1T+qEOT1vujDEHbN/N5Y80bud7tlhAKlbQ6Yv+2gBIrPiDjLN6ZpT9tFyiZW7xa32Gg==","signatures":[{"sig":"MEUCIFh54ifWUkJlv0/4M+RSOx0F009rlu6uot3UNY5x36EqAiEAh8EIlEvuSh6FAFM1+KE9XKywKSGgG5wQhY3otgLkqfA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIFJY7Th9Ap7iviFYQHw9YKTM6fgShQyWRof4uzNp8f2UAiEA5WpXtGPWV/CG/GamYqTXRGJb+SRyriG7zxseri9oKcI="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/pdflince-mcp@1.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":2101135},"name":"pdflince-mcp","type":"module","engines":{"bun":">=1.0.0","node":">=18.0.0"},"gitHead":"ed714ed9e18780c80702ab51e3391bc4ee161ce0","license":"MIT","scripts":{"dev":"cross-env STRICT_LINT=true next dev --turbo","lint":"cross-env STRICT_LINT=true next lint","build":"next build","start":"bunx serve out --single","prepack":"bun run build:mcp","prepare":"node scripts/setup-pdf-worker.mjs","preview":"bun run build && bunx serve out --single","lint:fix":"cross-env STRICT_LINT=true next lint --fix","test:e2e":"playwright test","test:mcp":"bun test tests/mcp","build:mcp":"bun build ./src/mcp/index.ts --target node --outfile ./bin/pdflince-mcp.js"},"version":"1.1.1","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"20741df9-8d3b-4e1b-92d8-818b3c8ecd02"}},"homepage":"https://pdflince.com/en/mcp","keywords":["pdf","pdf-tools","privacy","client-side","nextjs","react","pdf-lib","mcp","mcp-server","model-context-protocol","ai-agent","claude-mcp","cursor-mcp","hermes-agent","grok","ollama","deepseek"],"repository":{"url":"git+https://github.com/GSiesto/PDFLince.git","type":"git"},"_npmVersion":"11.19.0","description":"Privacy-first client-side PDF toolkit and local Model Context Protocol (MCP) server.","directories":{},"maintainers":[{"name":"gsiesto","email":"guillermosiesto@gmail.com"}],"_nodeVersion":"24.21.0","dependencies":{"zod":"^4.6.5","next":"^15.5.12","geist":"^1.3.0","react":"^18.3.1","pdf-lib":"^1.17.1","react-dom":"^18.3.0","pdfjs-dist":"^5.4.296","server-only":"^0.0.1","lucide-react":"^0.563.0","@modelcontextprotocol/sdk":"^1.32.1"},"_hasShrinkwrap":false,"devDependencies":{"jszip":"^3.10.1","serve":"^14.2.1","eslint":"^8.57.0","postcss":"^8.5.3","prettier":"^3.3.2","cross-env":"^7.0.3","typescript":"^5.5.3","@types/node":"^20.14.10","tailwindcss":"^3.4.17","@types/jszip":"^3.4.0","@types/react":"^18.3.3","autoprefixer":"^10.4.21","@types/eslint":"^8.56.10","@playwright/test":"^1.58.2","@types/react-dom":"^18.3.0","eslint-config-next":"^15.0.1","@tailwindcss/typography":"^0.5.16","@typescript-eslint/parser":"^8.1.0","prettier-plugin-tailwindcss":"^0.6.5","@typescript-eslint/eslint-plugin":"^8.1.0"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/pdflince-mcp_1.1.1_1792314678875_0.9413677026270837"}}},"time":{"created":"2026-10-18T08:57:00.097Z","modified":"2026-10-18T09:11:19.358Z","0.0.0-stage":"2026-10-18T08:57:00.097Z","1.1.0":"2026-10-18T09:03:11.596Z","1.1.1":"2026-10-18T09:11:18.975Z"},"bugs":{"url":"https://github.com/GSiesto/PDFLince/issues"},"license":"MIT","homepage":"https://pdflince.com/en/mcp","keywords":["pdf","pdf-tools","privacy","client-side","nextjs","react","pdf-lib","mcp","mcp-server","model-context-protocol","ai-agent","claude-mcp","cursor-mcp","hermes-agent","grok","ollama","deepseek"],"repository":{"url":"git+https://github.com/GSiesto/PDFLince.git","type":"git"},"description":"Privacy-first client-side PDF toolkit and local Model Context Protocol (MCP) server.","maintainers":[{"name":"gsiesto","email":"guillermosiesto@gmail.com"}],"readme":"# PDFLince\n\n<img src=\"./public/images/stickers/pdflince_logo_processed.webp\" alt=\"PDFLince Logo\" width=\"128\" />\n\n**The Privacy-First Client-Side PDF Toolkit.**\n\n[![Official Website](https://img.shields.io/badge/Website-pdflince.com-blue?style=for-the-badge&logo=google-chrome)](https://pdflince.com/en?utm_source=github&utm_medium=readme&utm_campaign=pdflince_public)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)\n[![Build Status](https://github.com/GSiesto/pdflince/actions/workflows/deploy.yml/badge.svg?style=for-the-badge)](https://github.com/GSiesto/pdflince/actions)\n\n| Language | Link |\n| :--- | :--- |\n| 🇬🇧 English | [pdflince.com/en](https://pdflince.com/en?utm_source=github&utm_medium=readme&utm_campaign=pdflince_public) |\n| 🇪🇸 Español | [pdflince.com](https://pdflince.com/?utm_source=github&utm_medium=readme&utm_campaign=pdflince_public) |\n| 🇫🇷 Français | [pdflince.com/fr](https://pdflince.com/fr?utm_source=github&utm_medium=readme&utm_campaign=pdflince_public) |\n| 🇩🇪 Deutsch | [pdflince.com/de](https://pdflince.com/de?utm_source=github&utm_medium=readme&utm_campaign=pdflince_public) |\n| 🇵🇹 Português | [pdflince.com/pt](https://pdflince.com/pt?utm_source=github&utm_medium=readme&utm_campaign=pdflince_public) |\n| 🇮🇹 Italiano | [pdflince.com/it](https://pdflince.com/it?utm_source=github&utm_medium=readme&utm_campaign=pdflince_public) |\n| 🇷🇴 Română | [pdflince.com/ro](https://pdflince.com/ro?utm_source=github&utm_medium=readme&utm_campaign=pdflince_public) |\n| 🇷🇺 Русский | [pdflince.com/ru](https://pdflince.com/ru?utm_source=github&utm_medium=readme&utm_campaign=pdflince_public) |\n| 🇭🇺 Magyar | [pdflince.com/hu](https://pdflince.com/hu?utm_source=github&utm_medium=readme&utm_campaign=pdflince_public) |\n\n## Why PDFLince?\n\nMost online PDF tools require you to upload your sensitive documents to their cloud servers for processing. This creates privacy risks and compliance issues.\n\n**PDFLince is different:**\n- **Zero Server Uploads**: All logic runs in your browser via `pdf-lib` and Web Workers.\n- **Privacy by Design**: Ideal for contracts, bank statements, and personal data.\n- **Offline Capable**: Works even without an internet connection once loaded.\n- **No File Size Limits**: Bypasses server payload limits since it uses your device's memory.\n\n## Features\n\n- **Compress**: Smart compression with adaptive image downscaling (WebWorker-powered).\n- **Merge**: Combine multiple PDFs into one document.\n- **Split**: Extract ranges or split every page into separate files.\n- **Convert**: PDF to Image (JPG, PNG) and Image to PDF.\n- **Organize**: Extract pages, reorder pages, and delete pages visually.\n- **Crop**: Crop PDF pages manually with visual selection or by specifying precise values\n- **Rotate**: Rotate selected pages and preview changes in real-time before exporting.\n- **Secure**: 100% local processing verifiable via Network tab.\n- **Multilingual**: Native support for 9 languages (English, Spanish, French, German, Portuguese, Italian, Romanian, Russian, Hungarian).\n\n## Architecture\n\nBuilt with a focus on performance and code quality. The key differentiator is the **Zero-Server Data Flow**:\n\n```mermaid\ngraph TD\n    User[\"👤 User\"] -->|1. Select PDF| UI[\"💻 Browser UI (Next.js)\"]\n    UI -->|2. Offload work| Worker[\"⚙️ Web Worker\"]\n    \n    subgraph Client [\"🔒 Client-Side (Your Device)\"]\n        UI\n        Worker\n        Engine[\"📦 PDF-lib / PDF.js\"]\n        Worker -->|3. Process| Engine\n        Engine -->|4. Result| Worker\n    end\n    \n    subgraph Cloud [\"☁️ Static Hosting\"]\n        CDN[\"AWS CloudFront / S3\"]\n        CDN -->|0. Load App Code| UI\n    end\n    \n    Worker -->|5. Blob URL| Download[\"📂 Download File\"]\n    \n    %% Privacy Barrier\n    linkStyle 4 stroke:green,stroke-width:2px;\n    \n    style Client fill:#e6fffa,stroke:#00b894,stroke-width:2px\n    style Cloud fill:#dfe6e9,stroke:#636e72,stroke-dasharray: 5 5\n```\n\n- **Framework**: [Next.js 15](https://nextjs.org/) (App Router, Static Export).\n- **Core Engine**: [pdf-lib](https://pdf-lib.js.org/) & [PDF.js](https://mozilla.github.io/pdf.js/).\n- **Concurrency**: Web Workers for non-blocking UI during heavy compression tasks.\n- **Styling**: Tailwind CSS with a custom design system.\n- **Testing**: Playwright End-to-End test suite ensuring reliability across all operations.\n\n## Local Development\n\n### Prerequisites\n- Bun 1.0+\n\n### Quick Start\n\n1.  **Clone the repository:**\n    ```bash\n    git clone https://github.com/GSiesto/pdflince.git\n    cd pdflince\n    ```\n\n2.  **Install dependencies:**\n    ```bash\n    bun install\n    ```\n\n3.  **Run development server:**\n    ```bash\n    bun run dev\n    ```\n\n4.  **Open in browser:**\n    Navigate to [http://localhost:3000](http://localhost:3000).\n\n## Model Context Protocol (MCP) Server\n\nPDFLince includes an official [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server that empowers AI assistants, IDEs, and autonomous coding agents to inspect and manipulate local PDF files with **100% privacy and zero cloud uploads**.\n\n### Compatibility\n\n* **Supported MCP Hosts & IDEs:** Claude Desktop, Cursor, Antigravity, Windsurf, VS Code (via Cline, Roo Code, or Continue), Zed, and Open WebUI.\n* **Supported Models & Reasoning Engines:**\n  * **Frontier Cloud Models:** Claude (Anthropic), Grok (xAI via API in Cline/Open WebUI), GPT-4o (OpenAI), Gemini (Google).\n  * **Local & Open-Weights Models:** Nous Hermes (Hermes 3), DeepSeek (V3 / R1), Llama 3, Qwen, and Mistral running locally on **Ollama**, **LM Studio**, or **vLLM**.\n  * **Privacy Guarantee:** If you run local models like Nous Hermes or DeepSeek for strict data sovereignty, PDFLince ensures your PDF documents never leave your local filesystem.\n\n### Available Tools\n\n* `pdflince_inspect`: Inspect page count, dimensions, orientation, and document metadata without mutation.\n* `pdflince_merge`: Combine multiple PDFs with optional blank divider pages and custom metadata.\n* `pdflince_split`: Split PDFs into chunks based on page count, with optional ZIP archiving.\n* `pdflince_extract`: Extract specific pages or page ranges (e.g. `\"1-3, 5\"`).\n* `pdflince_reorder`: Reorder or drop pages according to a specified sequence.\n* `pdflince_rotate`: Rotate pages clockwise or counter-clockwise (90°, 180°, 270°).\n* `pdflince_crop`: Trim margins from page borders (top, bottom, left, right in points).\n* `pdflince_compress`: Optimize stream structure, downscale embedded images (150/72 DPI), prune annotations, and remove metadata.\n* `pdflince_pdf_to_images`: Render PDF pages into PNG or JPEG images at configurable DPI (72, 144, 300) and quality, with optional ZIP bundling.\n* `pdflince_images_to_pdf`: Convert local image files (PNG, JPG, WebP, TIFF) into a formatted PDF document.\n\n### Client Configuration\n\nAdd PDFLince to your client's MCP configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"pdflince\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"pdflince-mcp@latest\"]\n    }\n  }\n}\n```\n\nTo run locally from the repository:\n```bash\nbun run build:mcp\nnode ./bin/pdflince-mcp.js\n```\n\n\n## Contributing\n\nContributions are welcome! Whether it's fixing bugs, improving documentation, or proposing new features.\n\nPlease read our [Contributing Guidelines](CONTRIBUTING.md) and [Code of Conduct](CODE_OF_CONDUCT.md) before getting started.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## About the Name\n\n\"Lince\" means **Lynx** in Spanish. The **Iberian Lynx** (*Lynx pardinus*) is a wild cat species native to the Iberian Peninsula (Spain/Portugal). It was once the most endangered feline species in the world, but conservation efforts are helping its population recover.\n\nJust like the lynx, this tool is fast, sharp, and native to its environment (your browser). 🐱\n","readmeFilename":"README.md"}