@baruchiro/paperless-mcp 0.0.0 → 0.0.2

package/README.md

@@ -15,33 +15,37 @@ npx -y @smithery/cli install @baruchiro/paperless-mcp --client claude
 ```
 
 ### Manual Installation
-1. Install the MCP server:
-```bash
-npm install -g paperless-mcp
-```
 
-2. Add it to your Claude's MCP configuration:
+Add these to your MCP config file:
 
-For VSCode extension, edit `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`:
+// STDIO mode (recommended for local or CLI use)
 ```json
-{
-  "mcpServers": {
-    "paperless": {
-      "command": "npx",
-      "args": ["paperless-mcp", "http://your-paperless-instance:8000", "your-api-token"]
-    }
+"paperless": {
+  "command": "npx",
+  "args": [
+    "-y",
+    "@baruchiro/paperless-mcp@latest",
+  ],
+  "env": {
+    "PAPERLESS_URL": "http://your-paperless-instance:8000",
+    "PAPERLESS_API_KEY": "your-api-token"
   }
 }
 ```
 
-For Claude desktop app, edit `~/Library/Application Support/Claude/claude_desktop_config.json`:
+// HTTP mode (recommended for Docker or remote use)
 ```json
-{
-  "mcpServers": {
-    "paperless": {
-      "command": "npx",
-      "args": ["paperless-mcp", "http://your-paperless-instance:8000", "your-api-token"]
-    }
+"paperless": {
+  "command": "docker",
+  "args": [
+    "run",
+    "-i",
+    "--rm",
+    "ghcr.io/baruchiro/paperless-mcp:latest",
+  ],
+  "env": {
+    "PAPERLESS_URL": "http://your-paperless-instance:8000",
+    "PAPERLESS_API_KEY": "your-api-token"
   }
 }
 ```
@@ -58,7 +62,7 @@ For Claude desktop app, edit `~/Library/Application Support/Claude/claude_deskto
 
 That's it! Now you can ask Claude to help you manage your Paperless-NGX documents.
 
-## Example Usage
+### Example Usage
 
 Here are some things you can ask Claude to do:
 

package/build/index.d.ts

@@ -1 +1,2 @@
+#!/usr/bin/env node
 export {};

package/build/index.js

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 "use strict";
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
@@ -17,45 +18,33 @@ const sse_js_1 = require("@modelcontextprotocol/sdk/server/sse.js");
 const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
 const streamableHttp_js_1 = require("@modelcontextprotocol/sdk/server/streamableHttp.js");
 const express_1 = __importDefault(require("express"));
+const node_util_1 = require("node:util");
 const PaperlessAPI_1 = require("./api/PaperlessAPI");
 const correspondents_1 = require("./tools/correspondents");
 const documents_1 = require("./tools/documents");
 const documentTypes_1 = require("./tools/documentTypes");
 const tags_1 = require("./tools/tags");
-// Simple CLI argument parsing
-const args = process.argv.slice(2);
-const useHttp = args.includes("--http");
-let port = 3000;
-const portIndex = args.indexOf("--port");
-if (portIndex !== -1 && args[portIndex + 1]) {
-    const parsed = parseInt(args[portIndex + 1], 10);
-    if (!isNaN(parsed))
-        port = parsed;
+const { values: { baseUrl, token, http: useHttp, port }, } = (0, node_util_1.parseArgs)({
+    options: {
+        baseUrl: { type: "string" },
+        token: { type: "string" },
+        http: { type: "boolean", default: false },
+        port: { type: "string" },
+    },
+    allowPositionals: true,
+});
+const resolvedBaseUrl = baseUrl || process.env.PAPERLESS_URL;
+const resolvedToken = token || process.env.PAPERLESS_API_KEY;
+const resolvedPort = port ? parseInt(port, 10) : 3000;
+if (!resolvedBaseUrl || !resolvedToken) {
+    console.error("Usage: paperless-mcp --baseUrl <url> --token <token> [--http] [--port <port>]");
+    console.error("Or set PAPERLESS_URL and PAPERLESS_API_KEY environment variables.");
+    process.exit(1);
 }
 function main() {
     return __awaiter(this, void 0, void 0, function* () {
-        let baseUrl;
-        let token;
-        if (useHttp) {
-            baseUrl = process.env.PAPERLESS_URL;
-            token = process.env.API_KEY;
-            if (!baseUrl || !token) {
-                console.error("When using --http, PAPERLESS_URL and API_KEY environment variables must be set.");
-                process.exit(1);
-            }
-        }
-        else {
-            baseUrl = args[0];
-            token = args[1];
-            if (!baseUrl || !token) {
-                console.error("Usage: paperless-mcp <baseUrl> <token> [--http] [--port <port>]");
-                console.error("Example: paperless-mcp http://localhost:8000 your-api-token --http --port 3000");
-                console.error("When using --http, PAPERLESS_URL and API_KEY environment variables must be set.");
-                process.exit(1);
-            }
-        }
         // Initialize API client and server once
-        const api = new PaperlessAPI_1.PaperlessAPI(baseUrl, token);
+        const api = new PaperlessAPI_1.PaperlessAPI(resolvedBaseUrl, resolvedToken);
         const server = new mcp_js_1.McpServer({ name: "paperless-ngx", version: "1.0.0" });
         (0, documents_1.registerDocumentTools)(server, api);
         (0, tags_1.registerTagTools)(server, api);
@@ -146,8 +135,8 @@ function main() {
                     res.status(400).send("No transport found for sessionId");
                 }
             }));
-            app.listen(port, () => {
-                console.log(`MCP Stateless Streamable HTTP Server listening on port ${port}`);
+            app.listen(resolvedPort, () => {
+                console.log(`MCP Stateless Streamable HTTP Server listening on port ${resolvedPort}`);
             });
         }
         else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@baruchiro/paperless-mcp",
-  "version": "0.0.0",
+  "version": "0.0.2",
   "description": "Model Context Protocol (MCP) server for interacting with Paperless-NGX document management system. Enables AI assistants to manage documents, tags, correspondents, and document types through the Paperless-NGX API.",
   "main": "build/index.js",
   "bin": {
@@ -47,7 +47,8 @@
   },
   "devDependencies": {
     "@changesets/cli": "^2.29.4",
-  "@types/node": "^22.15.17",
+    "@types/express": "^5.0.2",
+    "@types/node": "^22.15.17",
     "ts-node": "^10.9.2"
   }
 }