paperless-mcp

概述

paperless-mcp 服务器实现了与 Paperless-NGX 文档管理系统的无缝集成，提供丰富的文档操作、标签管理、联系人处理和文档类型管理工具。使用 TypeScript 和 litemcp 框架构建，支持 stdio 和 HTTP 传输模式，提供灵活的部署方式。该服务器实现了 Paperless-NGX REST API，使用户能够通过 AI 助手的自然语言命令执行文档搜索、上传、批量操作和元数据管理。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• list_documentspage?: number, page_size?: number

  Get a paginated list of all documents

  试试:Show me all documents试试:List the first 10 documents
• get_documentid: number

  Get a specific document by ID

  试试:Get document 123试试:Show me details for document 456
• search_documentsquery: string

  Full-text search across documents

  试试:Search for documents containing 'invoice'试试:Find all tax returns
• download_documentid: number, original?: boolean

  Download a document file by ID

  试试:Download document 123试试:Get original file for document 456
• bulk_edit_documentsdocuments: number[], method: string, ...additionalParams

  Perform bulk operations on multiple documents

  试试:Add tag to documents 1,2,3试试:Merge documents 4 and 5
• post_documentfile: string, filename: string, ...optionalParams

  Upload a new document to Paperless-NGX

  试试:Upload invoice.pdf as new document试试:Create document from base64 content
• list_tags

  Get all tags

  试试:List all tags试试:Show me all available tags
• create_tagname: string, color?: string, match?: string, matching_algorithm?: string

  Create a new tag

  试试:Create tag 'Receipts' with color #FF0000试试:Add new tag 'Urgent'
• list_correspondents

  Get all correspondents

  试试:List all correspondents试试:Show me document senders
• create_correspondentname: string, match?: string, matching_algorithm?: string

  Create a new correspondent

  试试:Create correspondent 'ACME Corp'试试:Add new sender 'Bank XYZ'
• list_document_types

  Get all document types

  试试:List all document types试试:Show me document categories
• create_document_typename: string, match?: string, matching_algorithm?: string

  Create a new document type

  试试:Create document type 'Invoice'试试:Add new category 'Bank Statement'

可对比工具

安装

npm install -g paperless-mcp

{
  "mcpServers": {
    "paperless": {
      "command": "npx",
      "args": ["paperless-mcp", "http://your-paperless-instance:8000", "your-api-token"]
    }
  }
}

{
  "mcpServers": {
    "paperless": {
      "command": "npx",
      "args": ["paperless-mcp", "http://your-paperless-instance:8000", "your-api-token"]
    }
  }
}

FAQ

如何为 Paperless-NGX 生成 API 令牌？

登录您的 Paperless-NGX 实例，点击右上角的用户名，选择'我的个人资料'，然后点击圆形箭头按钮生成新令牌。

我可以在 HTTP 模式下运行此 MCP 服务器吗？

是的，使用 `--http` 标志通过 `npm run start` 作为 HTTP 服务运行。可以使用 `--port` 指定端口（默认：3000）。

paperless-mcp 对比