@aipermission/mcp 0.2.37 → 0.2.39

package/dist/server.js

@@ -11,6 +11,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
 import { callVaultActionSchema, listVaultItemsSchema, vaultActionRequestSchema } from "./vault-tools.js";
+import { MCP_SERVER_INSTRUCTIONS } from "./instructions.js";
 import { normalizeLocalAPIURL } from "./local-url.js";
 import { jsonToolResult } from "./results.js";
 
@@ -19,10 +20,13 @@ const apiUrl = normalizeLocalAPIURL(process.env.AIPERMISSION_API_URL);
 const apiToken = process.env.AIPERMISSION_API_TOKEN || "";
 const apiTimeoutMs = Number.parseInt(process.env.AIPERMISSION_HTTP_TIMEOUT_MS || "60000", 10);
 
-const server = new McpServer({
-  name: "aipermission",
-  version: packageMetadata.version,
-});
+const server = new McpServer(
+  {
+    name: "aipermission",
+    version: packageMetadata.version,
+  },
+  { instructions: MCP_SERVER_INSTRUCTIONS },
+);
 
 server.tool(
   "list_connector_targets",
@@ -30,7 +34,7 @@ server.tool(
   {},
   async () => {
     return jsonToolResult(() => apiGet("/api/mcp/connector-targets"));
-  }
+  },
 );
 
 server.tool(
@@ -44,7 +48,7 @@ server.tool(
       const params = new URLSearchParams({ target_ref });
       return apiGet(`/api/mcp/connector-help?${params.toString()}`);
     });
-  }
+  },
 );
 
 server.tool(
@@ -58,7 +62,7 @@ server.tool(
       const params = new URLSearchParams({ target_ref });
       return apiGet(`/api/mcp/connector-actions?${params.toString()}`);
     });
-  }
+  },
 );
 
 server.tool(
@@ -69,17 +73,24 @@ server.tool(
     action_name: z.string().min(1).describe("Action name from get_connector_actions."),
     input: z.record(z.unknown()).optional().describe("Connector-specific action input."),
     reason: z.string().optional().describe("Why this connector action is needed."),
-    idempotency_key: z.string().min(1).max(128).optional().describe("Caller-stable key that makes retries return the original request without running twice."),
+    idempotency_key: z
+      .string()
+      .min(1)
+      .max(128)
+      .optional()
+      .describe("Caller-stable key that makes retries return the original request without running twice."),
   },
   async ({ target_ref, action_name, input, reason, idempotency_key }) => {
-    return jsonToolResult(() => apiPost("/api/mcp/connector-actions/call", {
-      target_ref,
-      action_name,
-      input: input || {},
-      reason: reason || "",
-      idempotency_key,
-    }));
-  }
+    return jsonToolResult(() =>
+      apiPost("/api/mcp/connector-actions/call", {
+        target_ref,
+        action_name,
+        input: input || {},
+        reason: reason || "",
+        idempotency_key,
+      }),
+    );
+  },
 );
 
 server.tool(
@@ -90,7 +101,7 @@ server.tool(
   },
   async ({ request_id }) => {
     return jsonToolResult(() => apiGet(`/api/mcp/connector-action-requests/${request_id}`));
-  }
+  },
 );
 
 server.tool(
@@ -104,7 +115,7 @@ server.tool(
       const query = params.toString();
       return apiGet(`/api/mcp/vault-items${query ? `?${query}` : ""}`);
     });
-  }
+  },
 );
 
 server.tool(
@@ -112,14 +123,16 @@ server.tool(
   "Run a Vault action under the configured project capability. Prompt waits for local approval; Always executes immediately through the same tracked request path. generate_item input accepts name, secret_type, generator_kind, provider, environment, description, expires_at, expiry_warning_days, tags (string array), usage_notes (array of {location, notes}), and shared_project_ids (integer array). restart_session_with_environment input requires target_ref and items with item_id, source_project_id, and optional replace_existing. Never include raw secret values.",
   callVaultActionSchema,
   async ({ project_ref, action_name, input, reason, idempotency_key }) => {
-    return jsonToolResult(() => apiPost("/api/mcp/vault-actions/call", {
-      project_ref,
-      action_name,
-      input,
-      reason,
-      idempotency_key,
-    }));
-  }
+    return jsonToolResult(() =>
+      apiPost("/api/mcp/vault-actions/call", {
+        project_ref,
+        action_name,
+        input,
+        reason,
+        idempotency_key,
+      }),
+    );
+  },
 );
 
 server.tool(
@@ -128,7 +141,7 @@ server.tool(
   vaultActionRequestSchema,
   async ({ request_id }) => {
     return jsonToolResult(() => apiGet(`/api/mcp/vault-action-requests/${request_id}`));
-  }
+  },
 );
 
 server.tool(
@@ -137,7 +150,7 @@ server.tool(
   vaultActionRequestSchema,
   async ({ request_id }) => {
     return jsonToolResult(() => apiPost(`/api/mcp/vault-action-requests/${request_id}/cancel`, {}));
-  }
+  },
 );
 
 const transport = new StdioServerTransport();
@@ -190,7 +203,7 @@ async function apiFetch(path, options) {
     });
   } catch (error) {
     if (error?.name === "AbortError") {
-      throw new Error(`AIPermission API request timed out after ${timeout}ms`);
+      throw new Error(`AIPermission API request timed out after ${timeout}ms`, { cause: error });
     }
     throw error;
   } finally {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aipermission/mcp",
-  "version": "0.2.37",
+  "version": "0.2.39",
   "mcpName": "io.github.aipermission/aipermission-mcp",
   "description": "Local-first MCP bridge for the aipermission gateway.",
   "license": "AGPL-3.0-only",
@@ -28,16 +28,34 @@
   ],
   "scripts": {
     "build": "node scripts/build.js",
+    "format": "prettier --write \"src/**/*.js\" \"test/**/*.js\" \"scripts/**/*.js\"",
+    "format:check": "prettier --check \"src/**/*.js\" \"test/**/*.js\" \"scripts/**/*.js\"",
+    "lint": "eslint src test scripts",
     "prepack": "npm run build",
-    "test": "node --test test/*.test.js",
+    "test": "npm run build && node --test test/*.test.js",
     "start": "node dist/cli.js",
     "dev": "node src/cli.js"
   },
   "engines": {
     "node": ">=20"
   },
+  "devEngines": {
+    "runtime": {
+      "name": "node",
+      "version": ">=20.19.0",
+      "onFail": "error"
+    }
+  },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.30.0",
+    "smol-toml": "1.8.0",
+    "yaml": "2.9.0",
     "zod": "3.25.76"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "eslint": "^10.9.1",
+    "globals": "^17.11.0",
+    "prettier": "^3.9.6"
   }
 }

package/server.json

@@ -3,12 +3,12 @@
   "name": "io.github.aipermission/aipermission-mcp",
   "title": "AIPermission",
   "description": "Local-first MCP bridge for the AIPermission gateway.",
-  "version": "0.2.37",
+  "version": "0.2.39",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@aipermission/mcp",
-      "version": "0.2.37",
+      "version": "0.2.39",
       "transport": {
         "type": "stdio"
       }