Paperless MCP (Barryw)

无纸化MCP

停止手动组织文档。让AI来做吧。

  

您有一个Paperless ngx实例。你有数百（数千？）份文件。你 *知道* 你应该给它们贴上标签，设置通讯员，正确地组织它们。但谁有时间呢？

PaperlessMCP将您的Paperless-ngx连接到任何兼容MCP的AI。现在，您只需问：

“查找我2023年以来的所有税务文件” “将这50张发票标记为‘业务费用’，并将对应方设置为‘Acme Corp’” “上传此收据并找出它是什么” “我的保险文件夹中缺少哪些文件？”

这是LLM类固醇上的Paperless ngx。设计的界面 *具体地* 让AI在你做任何其他事情的同时管理你的文档。

______________________________________________________________________

AI能用你的无纸化做什么？

一切。对每种实体类型进行完整的CRUD操作：

43工具 涵盖：

• 文件 --搜索、上传、下载、更新、删除、批量操作、OCR再处理
• 标签 --带有颜色和匹配规则的完整CRUD
• 记者 --追踪谁给你寄东西
• 文档类型 --对发票、收据、合同等进行分类
• 存储路径 --使用智能模板组织文件
• 自定义字段 --添加您自己的元数据（日期、金额、URL等）

所有破坏性操作都需要明确确认，并默认为干运行模式。人工智能不会意外地摧毁你的档案。

______________________________________________________________________

无纸化MCP适合您吗？

是的，如果：

• 您运行的是Paperless ngx（自托管或云）
• 您可以使用任何会说MCP（Claude或任何其他支持该协议的AI助手）的人工智能助手
• 你积压了大量未标记的文件，对此感到内疚
• 你宁愿说“组织这个”，也不愿点击47个按钮
• 您想用简单的英语查询文档
• 你认为电脑应该为你工作，而不是相反

否，如果：

• 你不使用Paperless ngx（这不是一个通用的文档工具）
• 你喜欢手动标记文档（奇怪，但尊重）
• 你不信任AI处理你的文件（这是公平的，但你可以先对所有内容进行模拟运行）

最佳点： 你有Paperless运行，你有一个兼容MCP的AI，你希望他们成为朋友。

______________________________________________________________________

入门指南

你需要

1. 无纸化ngx实例 使用API令牌

*（设置→ Django管理员→ 代币→ 为您的用户创建一个）*

1. 与MCP兼容的AI （克劳德桌面，或任何符合协议的东西）

选项1:Docker（推荐）

从零到与文档对话的最快路径。


docker run -d \
  --name paperless-mcp \
  --restart unless-stopped \
  -e PAPERLESS_BASE_URL=https://your-paperless.example.com \
  -e PAPERLESS_API_TOKEN=your-token-here \
  -p 5000:5000 \
  ghcr.io/barryw/paperlessmcp:vX.Y.Z

从上面的徽章中获取版本。 我们不使用 latest 因为 您值得进行可重复的部署.

将您的MCP客户端连接到 http://localhost:5000/mcp 然后开始处理你的文件。

选项2：克劳德桌面

添加到您的配置文件中：

{
  "mcpServers": {
    "paperless": {
      "command": "dotnet",
      "args": ["run", "--project", "/path/to/PaperlessMCP/PaperlessMCP", "--", "--stdio"],
      "env": {
        "PAPERLESS_BASE_URL": "https://your-paperless.example.com",
        "PAPERLESS_API_TOKEN": "your-token-here"
      }
    }
  }
}

重新启动克劳德桌面。寻找工具图标——Paperless应该在那里。

选项3：克劳德代码

如果您已经在某处运行服务器，请执行一个命令：

# Connect to a running HTTP/SSE server
claude mcp add --transport sse paperless http://localhost:5000/mcp

或者使用stdio从源代码运行：

claude mcp add --transport stdio paperless \
  -e PAPERLESS_BASE_URL=https://your-paperless.example.com \
  -e PAPERLESS_API_TOKEN=your-token-here \
  -- dotnet run --project /path/to/PaperlessMCP/PaperlessMCP -- --stdio

验证它是否存在：

claude mcp list

选项4:Kubernetes

适用于跑k8s的家庭主妇。我们包括具有Kustomize支持的即用型清单。

# Clone and customize
git clone https://github.com/barryw/PaperlessMCP.git
cd PaperlessMCP/k8s

# Create your secrets
kubectl create secret generic paperless-mcp \
  --from-literal=PAPERLESS_BASE_URL=https://your-paperless.example.com

kubectl create secret generic paperless-token \
  --from-literal=token=your-api-token-here

# Deploy (edit the image tag first)
kubectl apply -k .

查看清单

包括：部署、服务、入口、Kustomization。根据口味调整。

选项5：来源

对于贡献者和修补匠：

git clone https://github.com/barryw/PaperlessMCP.git
cd PaperlessMCP
dotnet run --project PaperlessMCP             # HTTP/SSE on :5000
dotnet run --project PaperlessMCP -- --stdio  # stdio mode

需要 .NET 10 SDK.

______________________________________________________________________

完整工具箱

43种工具，按它们所接触的东西排列。每个实体都支持完整的CRUD。

Documents — the main event

Tags — organize everything

Correspondents — who sends you stuff

Document Types — invoices, receipts, contracts...

Storage Paths — where things live

Custom Fields — your own metadata

Health — is it alive?

______________________________________________________________________

配置

环境变量。就是这样。没有要管理的配置文件。

支持的别名： PAPERLESS_URL 和 PAPERLESS_TOKEN 如果这是你的风格，也可以工作。

______________________________________________________________________

支持项目

如果PaperlessMCP为您节省了时间，请考虑支持开发：

](https://github.com/sponsors/barryw) 

每一点都有助于保持灯亮着，提交源源不断。

______________________________________________________________________

贡献

好的，请。我们使用基于主干的开发和传统的提交。

git clone https://github.com/barryw/PaperlessMCP.git
cd PaperlessMCP
dotnet build
dotnet test

规则：

• 常规承诺(feat:, fix:, docs:等）——版本自动跳变
• 测试通过或未合并
• 破坏性行动需要 confirm=true 默认情况下为干运行

看 贡献.md 完整的概述。

______________________________________________________________________

许可证

麻省理工学院 --你想做什么就做什么，别怪我。

______________________________________________________________________

致谢

• 无纸化ngx --值得构建的文档系统
• 模型上下文协议 --人工智能和其他一切之间的粘合剂
• 所有曾对未标记的文件感到内疚的人