@orellbuehler/paperless-mcp 1.0.0 → 1.0.2

package/README.md

@@ -75,6 +75,18 @@ claude mcp add paperless --scope user \
   -- node /path/to/paperless-mcp/dist/index.js
 ```
 
+### Regenerating the API spec
+
+`paperless-openapi.yaml` is the Paperless-ngx OpenAPI schema used as a reference when building tools. Pull a fresh copy straight from a running instance (no Docker needed):
+
+```bash
+PAPERLESS_URL=https://your-paperless-instance.example.com \
+PAPERLESS_TOKEN=your-api-token \
+npm run spec:update
+```
+
+This fetches `GET /api/schema/` and overwrites `paperless-openapi.yaml`. Run it whenever you upgrade Paperless-ngx.
+
 ## Available Tools
 
 ### Core API Tools
@@ -163,14 +175,28 @@ Browser-based clients are blocked unless you list their origin in
 `MCP_ALLOWED_ORIGINS`. If the server is reachable on a public hostname, set
 `MCP_ALLOWED_HOSTS` to the expected host(s) for DNS-rebinding protection.
 
-## Run as an HTTP sidecar (Docker Compose)
+## Run as an HTTP sidecar (Docker)
+
+A prebuilt image is published to the GitHub Container Registry on every release
+and every push to `main`:
+
+```
+ghcr.io/orellbuehler/paperless-mcp:latest   # tracks main
+ghcr.io/orellbuehler/paperless-mcp:1         # latest 1.x release
+ghcr.io/orellbuehler/paperless-mcp:1.0.0     # exact version
+```
 
-A `Dockerfile` is included. Add the server as a service next to your existing
-Paperless-ngx compose stack:
+Pull it directly:
+
+```bash
+docker pull ghcr.io/orellbuehler/paperless-mcp:latest
+```
+
+Add the server as a service next to your existing Paperless-ngx compose stack:
 
 ```yaml
 paperless-mcp:
-  build: https://github.com/<you>/paperless-mcp.git
+  image: ghcr.io/orellbuehler/paperless-mcp:latest
   restart: unless-stopped
   depends_on:
     - webserver
@@ -189,6 +215,18 @@ paperless-mcp:
     OPENAI_API_KEY: <key>
 ```
 
+The image already defaults to `MCP_TRANSPORT=http`, `PORT=3001`, and
+`PAPERLESS_MCP_DATA=/data`, so the only variables you must set are
+`PAPERLESS_URL` and `PAPERLESS_TOKEN` (plus `OPENAI_API_KEY` when semantic
+search is enabled). Mount a volume at `/data` to persist the embedding index
+across restarts.
+
 LAN clients connect to `http://<host>:3001/mcp` with their own Paperless API
 token. Run `sync_embeddings` once with the admin token to build the shared
 semantic index.
+
+To build the image yourself instead of pulling it, a `Dockerfile` is included:
+
+```bash
+docker build -t paperless-mcp .
+```

package/dist/paperless/format.js

@@ -6,10 +6,7 @@ export function buildQS(params) {
         if (Array.isArray(v)) {
             if (v.length === 0)
                 continue;
-            if (k === "id__in")
-                sp.set(k, v.join(","));
-            else
-                v.forEach((item) => sp.append(k, String(item)));
+            sp.set(k, v.join(","));
         }
         else {
             sp.set(k, String(v));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orellbuehler/paperless-mcp",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Model Context Protocol server for Paperless-ngx: documents, organization, saved views, users, workflows, and optional semantic search.",
   "type": "module",
   "bin": {
@@ -19,6 +19,7 @@
     "lint": "eslint src",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
+    "spec:update": "bash scripts/update-openapi.sh",
     "prepare": "npm run build"
   },
   "engines": {