agent-passport-system-mcp 2.8.2 → 2.8.5

package/README.md

@@ -12,24 +12,27 @@ MCP server for the [Agent Passport System](https://github.com/aeoess/agent-passp
 
 ## Quick Start
 
-### Remote (no install)
+### Fastest: Remote (no install needed)
 
-Connect directly via SSE — works with any MCP client:
+```
+npx agent-passport-system-mcp setup --remote
+```
+
+Connects via SSE to `mcp.aeoess.com/sse`. Zero dependencies. Restart your AI client.
+
+### Local install
 
-```json
-{
-  "mcpServers": {
-    "agent-passport": {
-      "type": "sse",
-      "url": "https://mcp.aeoess.com/sse"
-    }
-  }
-}
 ```
+npm install -g agent-passport-system-mcp
+npx agent-passport-system-mcp setup
+```
+
+Auto-configures Claude Desktop and Cursor. Restart your AI client. 61 tools ready.
 
-### Claude Desktop (local)
+<details>
+<summary>Manual config (if setup doesn't detect your client)</summary>
 
-Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+Add to your MCP config file:
 
 ```json
 {
@@ -42,20 +45,19 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 }
 ```
 
-### Cursor / Windsurf
-
-Add to your MCP config:
+Or for remote SSE:
 
 ```json
 {
   "mcpServers": {
     "agent-passport": {
-      "command": "npx",
-      "args": ["agent-passport-system-mcp"]
+      "type": "sse",
+      "url": "https://mcp.aeoess.com/sse"
     }
   }
 }
 ```
+</details>
 
 ## Tools (33)
 

package/build/bin.d.ts

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

package/build/bin.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+// Thin wrapper — checks argv BEFORE loading any MCP modules
+// Dynamic import() avoids ESM static import hoisting
+if (process.argv[2] === "setup") {
+    await import("./setup.js");
+    process.exit(0);
+}
+else {
+    await import("./index.js");
+}
+export {};

package/build/setup.d.ts

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

package/build/setup.js

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+// Auto-configure Agent Passport MCP for Claude Desktop, Cursor, Windsurf
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { homedir, platform } from "node:os";
+const LOCAL_CONFIG = {
+    command: "npx",
+    args: ["agent-passport-system-mcp"],
+};
+const REMOTE_CONFIG = {
+    type: "sse",
+    url: "https://mcp.aeoess.com/sse",
+};
+function getConfigPaths() {
+    const home = homedir();
+    const paths = [];
+    if (platform() === "darwin") {
+        paths.push({
+            name: "Claude Desktop",
+            path: join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json"),
+        });
+        paths.push({
+            name: "Cursor",
+            path: join(home, ".cursor", "mcp.json"),
+        });
+    }
+    else if (platform() === "win32") {
+        const appdata = process.env.APPDATA || join(home, "AppData", "Roaming");
+        paths.push({
+            name: "Claude Desktop",
+            path: join(appdata, "Claude", "claude_desktop_config.json"),
+        });
+        paths.push({
+            name: "Cursor",
+            path: join(home, ".cursor", "mcp.json"),
+        });
+    }
+    else {
+        paths.push({
+            name: "Claude Desktop",
+            path: join(home, ".config", "Claude", "claude_desktop_config.json"),
+        });
+        paths.push({
+            name: "Cursor",
+            path: join(home, ".cursor", "mcp.json"),
+        });
+    }
+    return paths;
+}
+function setup() {
+    const useRemote = process.argv.includes("--remote");
+    const serverConfig = useRemote ? REMOTE_CONFIG : LOCAL_CONFIG;
+    const mode = useRemote ? "remote (SSE)" : "local (npx)";
+    console.log(`\n🔑 Agent Passport MCP Setup (${mode})\n`);
+    const configs = getConfigPaths();
+    let configured = 0;
+    for (const { name, path } of configs) {
+        try {
+            let config = {};
+            if (existsSync(path)) {
+                const raw = readFileSync(path, "utf-8");
+                config = JSON.parse(raw);
+            }
+            else {
+                const dir = path.substring(0, path.lastIndexOf("/"));
+                mkdirSync(dir, { recursive: true });
+            }
+            if (!config.mcpServers)
+                config.mcpServers = {};
+            if (config.mcpServers["agent-passport"]) {
+                console.log(`  ✓ ${name} — already configured`);
+                configured++;
+                continue;
+            }
+            config.mcpServers["agent-passport"] = serverConfig;
+            writeFileSync(path, JSON.stringify(config, null, 2) + "\n");
+            console.log(`  ✓ ${name} — configured at ${path}`);
+            configured++;
+        }
+        catch {
+            // Config dir doesn't exist = app not installed, skip
+        }
+    }
+    if (configured === 0) {
+        console.log("  No supported MCP clients found.");
+        console.log("  Manual setup: add this to your MCP config:\n");
+        console.log(JSON.stringify({ mcpServers: { "agent-passport": serverConfig } }, null, 2));
+    }
+    else {
+        console.log(`\n  Restart your AI client to activate Agent Passport (61 tools).`);
+        console.log(`  Then say: "Create an agent identity" or "Delegate authority"\n`);
+        if (!useRemote) {
+            console.log(`  Tip: Use --remote for zero-install SSE mode: npx agent-passport-system-mcp setup --remote\n`);
+        }
+    }
+}
+setup();

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "agent-passport-system-mcp",
-  "version": "2.8.2",
+  "version": "2.8.5",
   "mcpName": "io.github.aeoess/agent-passport-mcp",
   "description": "MCP server for Agent Passport System — cryptographic identity, delegation, governance, and deliberation for AI agents",
   "type": "module",
   "bin": {
-    "agent-passport-system-mcp": "build/index.js"
+    "agent-passport-system-mcp": "./build/bin.js",
+    "agent-passport-mcp-setup": "./build/setup.js"
   },
   "files": [
     "build",
@@ -13,10 +14,11 @@
     "CODE_OF_CONDUCT.md"
   ],
   "scripts": {
-    "build": "tsc && chmod 755 build/index.js",
+    "build": "tsc && chmod 755 build/bin.js build/index.js build/setup.js",
     "watch": "tsc --watch",
     "inspector": "npx @modelcontextprotocol/inspector build/index.js",
     "prepublishOnly": "npm run build",
+    "postinstall": "echo '\\n🔑 Agent Passport MCP installed! Run: npx agent-passport-system-mcp setup\\n   Or for zero-install remote: npx agent-passport-system-mcp setup --remote\\n'",
     "postpublish": "cd ~/aeoess_web && node scripts/propagate.mjs --apply --commit 2>/dev/null || echo 'Propagation skipped (aeoess_web not found)'"
   },
   "keywords": [