{"id":30800621,"url":"https://github.com/pspdfkit/nutrient-document-engine-mcp-server","last_synced_at":"2025-09-05T20:11:06.237Z","repository":{"id":302535819,"uuid":"1012673734","full_name":"PSPDFKit/nutrient-document-engine-mcp-server","owner":"PSPDFKit","description":"A Model Context Protocol (MCP) server implementation exposes document processing capabilities through natural language, supporting both direct human interaction and AI agent tool calling.","archived":false,"fork":false,"pushed_at":"2025-07-30T04:10:03.000Z","size":26238,"stargazers_count":56,"open_issues_count":1,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-30T06:30:15.774Z","etag":null,"topics":["agentic-ai","document-processing","document-processor","mcp-server"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PSPDFKit.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-02T17:40:43.000Z","updated_at":"2025-07-30T04:10:00.000Z","dependencies_parsed_at":"2025-07-30T06:18:33.299Z","dependency_job_id":null,"html_url":"https://github.com/PSPDFKit/nutrient-document-engine-mcp-server","commit_stats":null,"previous_names":["pspdfkit/nutrient-document-engine-mcp-server"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/PSPDFKit/nutrient-document-engine-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PSPDFKit%2Fnutrient-document-engine-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PSPDFKit%2Fnutrient-document-engine-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PSPDFKit%2Fnutrient-document-engine-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PSPDFKit%2Fnutrient-document-engine-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PSPDFKit","download_url":"https://codeload.github.com/PSPDFKit/nutrient-document-engine-mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PSPDFKit%2Fnutrient-document-engine-mcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273813835,"owners_count":25172892,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-05T02:00:09.113Z","response_time":402,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic-ai","document-processing","document-processor","mcp-server"],"created_at":"2025-09-05T20:11:04.429Z","updated_at":"2025-09-05T20:11:06.222Z","avatar_url":"https://github.com/PSPDFKit.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Nutrient Document Engine MCP Server\n\n![Document workflows using natural language](https://raw.githubusercontent.com/PSPDFKit/nutrient-document-engine-mcp-server/main/resources/readme-header.png)\n\n[![npm](https://img.shields.io/npm/v/%40nutrient-sdk/document-engine-mcp-server)](https://www.npmjs.com/package/@nutrient-sdk/document-engine-mcp-server)\n\n**Connect AI agents to document processing.**\n\nThis MCP server exposes document processing capabilities through natural language, supporting both direct human interaction and AI agent tool calling.\n\n## Example Conversations\n\nOnce configured, you (or your agent) can interact with documents through natural language:\n\n**You:** *\"What documents do I have available?\"*  \n**AI:** *\"I can see you have 3 documents: annual-report.pdf, contract-draft.pdf, and tax-form-2023.pdf. Would you like me to analyze any of these?\"*\n\n**You:** *\"Extract all the names and phone numbers from these invoices\"*  \n**AI:** *\"I found 12 contacts: John Smith (555-0123), Sarah Johnson (555-0456)...\"*\n\n**You:** *\"Redact all social security numbers from these tax forms\"*  \n**AI:** *\"I've identified and redacted 3 SSNs across 2 documents. The redacted versions are ready.\"*\n\n**You:** *\"Split this 50-page contract into separate sections\"*  \n**AI:** *\"I've split the contract into 5 sections: Terms (pages 1-8), Payment (pages 9-15)...\"*\n\n## Setup with Claude Desktop\n\n![Document Engine MCP Server + Claude Desktop](https://raw.githubusercontent.com/PSPDFKit/nutrient-document-engine-mcp-server/main/resources/claude-document-engine-mcp.gif?raw=true)\n\n### Prerequisites\n- **Claude Desktop** - [Download from Anthropic](https://claude.ai/download).\n- **Docker Compose** - [Download from Docker](https://docs.docker.com/compose/). For running Nutrient Document Engine locally.\n- **Node.js 18+** - This MCP server runs via `npx`.\n\n### Licensing\n\nNutrient Document Engine runs with an evaluation license by default. Please see [Removing Evaluation Limitations](#removing-evaluation-watermarks-and-limitations) section on how to remove the evaluation limitations.\n\n### 1. Start Nutrient Document Engine\nOpen a terminal window, then run:\n\n```bash\ngit clone https://github.com/PSPDFKit/nutrient-document-engine-mcp.git\ncd nutrient-document-engine-mcp\ndocker-compose up -d\n```\n\n### 2. Connect Claude Desktop\n\nAdd this to your Claude Desktop config (Settings → Developer → Edit Config):\n\n```json\n{\n  \"mcpServers\": {\n    \"nutrient-document-engine\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@nutrient-sdk/document-engine-mcp-server\"],\n      \"env\": {\n        \"DASHBOARD_USERNAME\": \"admin\",\n        \"DASHBOARD_PASSWORD\": \"password\",\n        \"DOCUMENT_ENGINE_BASE_URL\": \"http://localhost:5000\",\n        \"DOCUMENT_ENGINE_API_AUTH_TOKEN\": \"secret\"\n      }\n    }\n  }\n}\n```\n\n### 3. Restart Claude Desktop\n\n### 4. Upload and Process Documents\n1. Open your web browser and go to http://localhost:5100/dashboard.\n2. Upload the documents you want to work with by using the drag-and-drop interface.\n3. Switch back to Claude Desktop and ask questions like:\n   *\"List my documents and extract text from the contract\"*\n\n## Features\n\nThis MCP server provides document processing tools in these areas:\n\n**Content Access**: Extract text, search documents, render pages as images, extract form data and table structures.\n\n**Document Editing**: Split documents, add watermarks, duplicate documents, fill PDF forms.\n\n**Security**: Create and apply redactions for sensitive data using preset patterns (SSNs, credit cards, etc.) or custom regex.\n\n**Annotations**: Add, read, and delete document annotations including highlights, notes, and stamps.\n\n**System**: Document discovery, metadata retrieval, and health monitoring.\n\n## Use with Other AI Platforms\n\nThis MCP server works with any AI platform that supports the Model Context Protocol:\n\n- **Claude Desktop** - Quick setup with the configuration above.\n- **LangGraph** - Integrate with [LangGraph agents](examples/langgraphjs) for complex workflows.\n- **OpenAI APIs** - Connect through MCP-compatible frameworks.\n- **Custom agents** - Any MCP-compatible AI system.\n\n## Examples and Documentation\n\n### Examples\n- [LangGraph Document Processing](examples/langgraphjs) - Workflow examples for contract processing, form filling, and report generation.\n- [OpenAI Agents SDK Document Processing](examples/openai-agents) - Workflow examples for contract processing, form filling, and report generation.\n- [Document Chat Interface](examples/document-chat) - Web application with React and LangGraph.\n- [Procurement AI Agent](examples/procurement-agent-ts) - An AI Agent written with Langgraph.js, that classifies and collates POs, invoices, and payment documents into groups and flags for human review\n\n### Documentation\n- [Configuration Guide](docs/configuration.md) - Environment variables, transport modes, dashboard.\n- [Features Reference](docs/features.md) - Detailed description of all document processing tools.\n- [Evaluation Framework](evaluation) - Testing and benchmarking tools.\n\n## Removing Evaluation Watermarks and Limitations\n\nDocument Engine runs in evaluation mode with limitations by default. To remove them:\n\n1. **Contact Sales to purchase a license** from [Nutrient](https://www.nutrient.io/contact-sales)\n2. **Configure your license** by setting the `ACTIVATION_KEY` environment variable in your [Docker Compose configuration](docker-compose.yml) or Document Engine setup\n3. **Restart Document Engine** to apply the license\n\nFor detailed licensing configuration, see the [Document Engine licensing guide](https://www.nutrient.io/guides/document-engine/about/licensing/).\n\n## Server Based Document Engine Setups\n\n**On-Premise Installation:** Follow the [Nutrient Document Engine installation guide](https://www.nutrient.io/getting-started/document-engine/).\n\n**Managed Cloud:** Use a hosted Document Engine instance - [setup guide](https://www.nutrient.io/guides/document-engine/deployment/managed-document-engine/).\n\n## Contributing\n\nWe welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, testing guidelines, and how to submit pull requests.\n\n## License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpspdfkit%2Fnutrient-document-engine-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpspdfkit%2Fnutrient-document-engine-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpspdfkit%2Fnutrient-document-engine-mcp-server/lists"}