@imagekit/api-mcp 7.3.0 → 7.4.0

package/options.mjs

@@ -1,45 +1,107 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 import qs from 'qs';
 import yargs from 'yargs';
 import { hideBin } from 'yargs/helpers';
 import z from 'zod';
+import { readEnv } from "./util.mjs";
 export function parseCLIOptions() {
     const opts = yargs(hideBin(process.argv))
-        .option('tools', {
+        .option('code-allow-http-gets', {
+        type: 'boolean',
+        description: 'Allow all code tool methods that map to HTTP GET operations. If all code-allow-* flags are unset, then everything is allowed.',
+    })
+        .option('code-allowed-methods', {
         type: 'string',
         array: true,
-        choices: ['code', 'docs'],
-        description: 'Use dynamic tools or all tools',
+        description: 'Methods to explicitly allow for code tool. Evaluated as regular expressions against method fully qualified names. If all code-allow-* flags are unset, then everything is allowed.',
     })
-        .option('no-tools', {
+        .option('code-blocked-methods', {
         type: 'string',
         array: true,
-        choices: ['code', 'docs'],
-        description: 'Do not use any dynamic or all tools',
+        description: 'Methods to explicitly block for code tool. Evaluated as regular expressions against method fully qualified names. If all code-allow-* flags are unset, then everything is allowed.',
     })
-        .option('transport', {
+        .option('code-execution-mode', {
         type: 'string',
-        choices: ['stdio', 'http'],
-        default: 'stdio',
-        description: 'What transport to use; stdio for local servers or http for remote servers',
+        choices: ['stainless-sandbox', 'local'],
+        default: 'stainless-sandbox',
+        description: "Where to run code execution in code tool; 'stainless-sandbox' will execute code in Stainless-hosted sandboxes whereas 'local' will execute code locally on the MCP server machine.",
+    })
+        .option('custom-instructions-path', {
+        type: 'string',
+        description: 'Path to custom instructions for the MCP server',
+    })
+        .option('debug', { type: 'boolean', description: 'Enable debug logging' })
+        .option('docs-dir', {
+        type: 'string',
+        description: 'Path to a directory of local documentation files (markdown/JSON) to include in local docs search.',
+    })
+        .option('docs-search-mode', {
+        type: 'string',
+        choices: ['stainless-api', 'local'],
+        default: 'stainless-api',
+        description: "Where to search documentation; 'stainless-api' uses the Stainless-hosted search API whereas 'local' uses an in-memory search index built from embedded SDK method data and optional local docs files.",
+    })
+        .option('log-format', {
+        type: 'string',
+        choices: ['json', 'pretty'],
+        description: 'Format for log output; defaults to json unless tty is detected',
+    })
+        .option('no-tools', {
+        type: 'string',
+        array: true,
+        choices: ['code', 'docs'],
+        description: 'Tools to explicitly disable',
     })
         .option('port', {
         type: 'number',
+        default: 3000,
         description: 'Port to serve on if using http transport',
     })
-        .option('socket', {
+        .option('socket', { type: 'string', description: 'Unix socket to serve on if using http transport' })
+        .option('stainless-api-key', {
+        type: 'string',
+        default: readEnv('STAINLESS_API_KEY'),
+        description: 'API key for Stainless. Used to authenticate requests to Stainless-hosted tools endpoints.',
+    })
+        .option('tools', {
+        type: 'string',
+        array: true,
+        choices: ['code', 'docs'],
+        description: 'Tools to explicitly enable',
+    })
+        .option('transport', {
         type: 'string',
-        description: 'Unix socket to serve on if using http transport',
+        choices: ['stdio', 'http'],
+        default: 'stdio',
+        description: 'What transport to use; stdio for local servers or http for remote servers',
     })
+        .env('MCP_SERVER')
+        .version(true)
         .help();
     const argv = opts.parseSync();
     const shouldIncludeToolType = (toolType) => argv.noTools?.includes(toolType) ? false
         : argv.tools?.includes(toolType) ? true
             : undefined;
+    const includeCodeTool = shouldIncludeToolType('code');
     const includeDocsTools = shouldIncludeToolType('docs');
     const transport = argv.transport;
+    const logFormat = argv.logFormat ? argv.logFormat
+        : process.stderr.isTTY ? 'pretty'
+            : 'json';
     return {
+        ...(includeCodeTool !== undefined && { includeCodeTool }),
         ...(includeDocsTools !== undefined && { includeDocsTools }),
+        debug: !!argv.debug,
+        stainlessApiKey: argv.stainlessApiKey,
+        docsSearchMode: argv.docsSearchMode,
+        docsDir: argv.docsDir,
+        codeAllowHttpGets: argv.codeAllowHttpGets,
+        codeAllowedMethods: argv.codeAllowedMethods,
+        codeBlockedMethods: argv.codeBlockedMethods,
+        codeExecutionMode: argv.codeExecutionMode,
+        customInstructionsPath: argv.customInstructionsPath,
         transport,
+        logFormat,
         port: argv.port,
         socket: argv.socket,
     };
@@ -55,11 +117,18 @@ const QueryOptions = z.object({
 export function parseQueryOptions(defaultOptions, query) {
     const queryObject = typeof query === 'string' ? qs.parse(query) : query;
     const queryOptions = QueryOptions.parse(queryObject);
+    let codeTool = queryOptions.no_tools && queryOptions.no_tools?.includes('code') ? false
+        : queryOptions.tools?.includes('code') ? true
+            : defaultOptions.includeCodeTool;
     let docsTools = queryOptions.no_tools && queryOptions.no_tools?.includes('docs') ? false
         : queryOptions.tools?.includes('docs') ? true
             : defaultOptions.includeDocsTools;
     return {
+        ...(codeTool !== undefined && { includeCodeTool: codeTool }),
         ...(docsTools !== undefined && { includeDocsTools: docsTools }),
+        codeExecutionMode: defaultOptions.codeExecutionMode,
+        docsSearchMode: defaultOptions.docsSearchMode,
+        docsDir: defaultOptions.docsDir,
     };
 }
 //# sourceMappingURL=options.mjs.map

package/options.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"options.mjs","sourceRoot":"","sources":["src/options.ts"],"names":[],"mappings":"OAAO,EAAE,MAAM,IAAI;OACZ,KAAK,MAAM,OAAO;OAClB,EAAE,OAAO,EAAE,MAAM,eAAe;OAChC,CAAC,MAAM,KAAK;AAYnB,MAAM,UAAU,eAAe;IAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;SACtC,MAAM,CAAC,OAAO,EAAE;QACf,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,gCAAgC;KAC9C,CAAC;SACD,MAAM,CAAC,UAAU,EAAE;QAClB,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,qCAAqC;KACnD,CAAC;SACD,MAAM,CAAC,WAAW,EAAE;QACnB,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC;QAC1B,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,2EAA2E;KACzF,CAAC;SACD,MAAM,CAAC,MAAM,EAAE;QACd,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,0CAA0C;KACxD,CAAC;SACD,MAAM,CAAC,QAAQ,EAAE;QAChB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,iDAAiD;KAC/D,CAAC;SACD,IAAI,EAAE,CAAC;IAEV,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IAE9B,MAAM,qBAAqB,GAAG,CAAC,QAAyB,EAAE,EAAE,CAC1D,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK;QACxC,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI;YACvC,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,gBAAgB,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAEvD,MAAM,SAAS,GAAG,IAAI,CAAC,SAA6B,CAAC;IAErD,OAAO;QACL,GAAG,CAAC,gBAAgB,KAAK,SAAS,IAAI,EAAE,gBAAgB,EAAE,CAAC;QAC3D,SAAS;QACT,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC;AACJ,CAAC;AAED,MAAM,WAAW,GAAG,CAAyB,OAAU,EAAE,EAAE,CACzD,CAAC,CAAC,UAAU,CACV,CAAC,GAAG,EAAE,EAAE,CACN,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG;IACxB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACb,CAAC,CAAC,GAAG,EACP,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAC5B,CAAC;AAEJ,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IACvF,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IAC/F,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,4CAA4C,CAAC;CACrF,CAAC,CAAC;AAEH,MAAM,UAAU,iBAAiB,CAAC,cAA0B,EAAE,KAAc;IAC1E,MAAM,WAAW,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACxE,MAAM,YAAY,GAAG,YAAY,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAErD,IAAI,SAAS,GACX,YAAY,CAAC,QAAQ,IAAI,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK;QACxE,CAAC,CAAC,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI;YAC7C,CAAC,CAAC,cAAc,CAAC,gBAAgB,CAAC;IAEpC,OAAO;QACL,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,gBAAgB,EAAE,SAAS,EAAE,CAAC;KAChE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"options.mjs","sourceRoot":"","sources":["src/options.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imagekit/api-mcp",
-  "version": "7.3.0",
+  "version": "7.4.0",
   "description": "The official MCP Server for the Image Kit API",
   "author": "Image Kit <developer@imagekit.io>",
   "types": "./index.d.ts",
@@ -23,18 +23,26 @@
     "build": "bash ./build",
     "format": "prettier --write --cache --cache-strategy metadata . !dist",
     "tsn": "ts-node -r tsconfig-paths/register",
-    "lint": "eslint --ext ts,js .",
-    "fix": "eslint --fix --ext ts,js ."
+    "lint": "eslint .",
+    "fix": "eslint --fix ."
   },
   "dependencies": {
-    "@imagekit/nodejs": "^7.3.0",
+    "@imagekit/nodejs": "^7.4.0",
+    "ajv": "^8.18.0",
     "@cloudflare/cabidela": "^0.2.4",
-    "@modelcontextprotocol/sdk": "^1.25.2",
+    "@hono/node-server": "^1.19.10",
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "hono": "^4.12.4",
     "@valtown/deno-http-worker": "^0.0.21",
+    "cookie-parser": "^1.4.6",
     "cors": "^2.8.5",
     "express": "^5.1.0",
     "fuse.js": "^7.1.0",
+    "minisearch": "^7.2.0",
     "jq-web": "https://github.com/stainless-api/jq-web/releases/download/v0.8.8/jq-web.tar.gz",
+    "pino": "^10.3.1",
+    "pino-http": "^11.0.0",
+    "pino-pretty": "^13.1.3",
     "qs": "^6.14.1",
     "typescript": "5.8.3",
     "yargs": "^17.7.2",
@@ -58,6 +66,22 @@
       "types": "./index.d.mts",
       "default": "./index.mjs"
     },
+    "./auth": {
+      "import": "./auth.mjs",
+      "require": "./auth.js"
+    },
+    "./auth.js": {
+      "default": "./auth.js"
+    },
+    "./auth.mjs": {
+      "default": "./auth.mjs"
+    },
+    "./code-tool-paths": {
+      "require": "./code-tool-paths.cjs"
+    },
+    "./code-tool-paths.cjs": {
+      "default": "./code-tool-paths.cjs"
+    },
     "./code-tool-types": {
       "import": "./code-tool-types.mjs",
       "require": "./code-tool-types.js"
@@ -68,6 +92,16 @@
     "./code-tool-types.mjs": {
       "default": "./code-tool-types.mjs"
     },
+    "./code-tool-worker": {
+      "import": "./code-tool-worker.mjs",
+      "require": "./code-tool-worker.js"
+    },
+    "./code-tool-worker.js": {
+      "default": "./code-tool-worker.js"
+    },
+    "./code-tool-worker.mjs": {
+      "default": "./code-tool-worker.mjs"
+    },
     "./code-tool": {
       "import": "./code-tool.mjs",
       "require": "./code-tool.js"
@@ -88,16 +122,6 @@
     "./docs-search-tool.mjs": {
       "default": "./docs-search-tool.mjs"
     },
-    "./headers": {
-      "import": "./headers.mjs",
-      "require": "./headers.js"
-    },
-    "./headers.js": {
-      "default": "./headers.js"
-    },
-    "./headers.mjs": {
-      "default": "./headers.mjs"
-    },
     "./http": {
       "import": "./http.mjs",
       "require": "./http.js"
@@ -118,6 +142,46 @@
     "./index.mjs": {
       "default": "./index.mjs"
     },
+    "./instructions": {
+      "import": "./instructions.mjs",
+      "require": "./instructions.js"
+    },
+    "./instructions.js": {
+      "default": "./instructions.js"
+    },
+    "./instructions.mjs": {
+      "default": "./instructions.mjs"
+    },
+    "./local-docs-search": {
+      "import": "./local-docs-search.mjs",
+      "require": "./local-docs-search.js"
+    },
+    "./local-docs-search.js": {
+      "default": "./local-docs-search.js"
+    },
+    "./local-docs-search.mjs": {
+      "default": "./local-docs-search.mjs"
+    },
+    "./logger": {
+      "import": "./logger.mjs",
+      "require": "./logger.js"
+    },
+    "./logger.js": {
+      "default": "./logger.js"
+    },
+    "./logger.mjs": {
+      "default": "./logger.mjs"
+    },
+    "./methods": {
+      "import": "./methods.mjs",
+      "require": "./methods.js"
+    },
+    "./methods.js": {
+      "default": "./methods.js"
+    },
+    "./methods.mjs": {
+      "default": "./methods.mjs"
+    },
     "./options": {
       "import": "./options.mjs",
       "require": "./options.js"
@@ -157,6 +221,16 @@
     },
     "./types.mjs": {
       "default": "./types.mjs"
+    },
+    "./util": {
+      "import": "./util.mjs",
+      "require": "./util.js"
+    },
+    "./util.js": {
+      "default": "./util.js"
+    },
+    "./util.mjs": {
+      "default": "./util.mjs"
     }
   }
 }

package/server.d.mts

@@ -1,13 +1,12 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { ClientOptions } from '@imagekit/nodejs';
-import ImageKit from '@imagekit/nodejs';
 import { McpOptions } from "./options.mjs";
-import { HandlerFunction, McpTool } from "./types.mjs";
-export { McpOptions } from "./options.mjs";
-export { ClientOptions } from '@imagekit/nodejs';
-export declare const newMcpServer: () => McpServer;
-export declare const server: McpServer;
+import { HandlerFunction, McpRequestContext, ToolCallResult, McpTool } from "./types.mjs";
+export declare const newMcpServer: ({ stainlessApiKey, customInstructionsPath, }: {
+    stainlessApiKey?: string | undefined;
+    customInstructionsPath?: string | undefined;
+}) => Promise<McpServer>;
 /**
  * Initializes the provided MCP Server with the given tools and handlers.
  * If not provided, the default client, tools and handlers will be used.
@@ -16,7 +15,14 @@ export declare function initMcpServer(params: {
     server: Server | McpServer;
     clientOptions?: ClientOptions;
     mcpOptions?: McpOptions;
-}): void;
+    stainlessApiKey?: string | undefined;
+    upstreamClientEnvs?: Record<string, string> | undefined;
+    mcpSessionId?: string | undefined;
+    mcpClientInfo?: {
+        name: string;
+        version: string;
+    } | undefined;
+}): Promise<void>;
 /**
  * Selects the tools to include in the MCP Server based on the provided options.
  */
@@ -24,8 +30,9 @@ export declare function selectTools(options?: McpOptions): McpTool[];
 /**
  * Runs the provided handler with the given client and arguments.
  */
-export declare function executeHandler(handler: HandlerFunction, client: ImageKit, args: Record<string, unknown> | undefined): Promise<import("./types").ToolCallResult>;
-export declare const readEnv: (env: string) => string | undefined;
-export declare const readEnvOrError: (env: string) => string;
-export declare const requireValue: <T>(value: T | undefined, description: string) => T;
+export declare function executeHandler({ handler, reqContext, args, }: {
+    handler: HandlerFunction;
+    reqContext: McpRequestContext;
+    args: Record<string, unknown> | undefined;
+}): Promise<ToolCallResult>;
 //# sourceMappingURL=server.d.mts.map

package/server.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.mts","sourceRoot":"","sources":["src/server.ts"],"names":[],"mappings":"OAEO,EAAE,MAAM,EAAE,MAAM,2CAA2C;OAC3D,EAAE,SAAS,EAAE,MAAM,yCAAyC;OAM5D,EAAE,aAAa,EAAE,MAAM,kBAAkB;OACzC,QAAQ,MAAM,kBAAkB;OAGhC,EAAE,UAAU,EAAE;OACd,EAAE,eAAe,EAAE,OAAO,EAAE;OAE5B,EAAE,UAAU,EAAE;OACd,EAAE,aAAa,EAAE,MAAM,kBAAkB;AAEhD,eAAO,MAAM,YAAY,iBAOtB,CAAC;AAGJ,eAAO,MAAM,MAAM,WAAiB,CAAC;AAErC;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE;IACpC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB,QAoEA;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,EAAE,CAM3D;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,QAAQ,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,6CAG1C;AAED,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,SAO9C,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,KAAK,MAAM,KAAG,MAM5C,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,CAAC,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,aAAa,MAAM,KAAG,CAK3E,CAAC"}
+{"version":3,"file":"server.d.mts","sourceRoot":"","sources":["src/server.ts"],"names":[],"mappings":"OAEO,EAAE,MAAM,EAAE,MAAM,2CAA2C;OAC3D,EAAE,SAAS,EAAE,MAAM,yCAAyC;OAM5D,EAAE,aAAa,EAAE,MAAM,kBAAkB;OAOzC,EAAE,UAAU,EAAE;OAEd,EAAE,eAAe,EAAE,iBAAiB,EAAE,cAAc,EAAE,OAAO,EAAE;AAEtE,eAAO,MAAM,YAAY,GAAU,8CAGhC;IACD,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,sBAAsB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7C,uBAUE,CAAC;AAEJ;;;GAGG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE;IAC1C,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACxD,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,aAAa,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;CAC/D,iBA0HA;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,EAAE,CAe3D;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,EACnC,OAAO,EACP,UAAU,EACV,IAAI,GACL,EAAE;IACD,OAAO,EAAE,eAAe,CAAC;IACzB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAC3C,GAAG,OAAO,CAAC,cAAc,CAAC,CAE1B"}

package/server.d.ts

@@ -1,13 +1,12 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { ClientOptions } from '@imagekit/nodejs';
-import ImageKit from '@imagekit/nodejs';
 import { McpOptions } from "./options.js";
-import { HandlerFunction, McpTool } from "./types.js";
-export { McpOptions } from "./options.js";
-export { ClientOptions } from '@imagekit/nodejs';
-export declare const newMcpServer: () => McpServer;
-export declare const server: McpServer;
+import { HandlerFunction, McpRequestContext, ToolCallResult, McpTool } from "./types.js";
+export declare const newMcpServer: ({ stainlessApiKey, customInstructionsPath, }: {
+    stainlessApiKey?: string | undefined;
+    customInstructionsPath?: string | undefined;
+}) => Promise<McpServer>;
 /**
  * Initializes the provided MCP Server with the given tools and handlers.
  * If not provided, the default client, tools and handlers will be used.
@@ -16,7 +15,14 @@ export declare function initMcpServer(params: {
     server: Server | McpServer;
     clientOptions?: ClientOptions;
     mcpOptions?: McpOptions;
-}): void;
+    stainlessApiKey?: string | undefined;
+    upstreamClientEnvs?: Record<string, string> | undefined;
+    mcpSessionId?: string | undefined;
+    mcpClientInfo?: {
+        name: string;
+        version: string;
+    } | undefined;
+}): Promise<void>;
 /**
  * Selects the tools to include in the MCP Server based on the provided options.
  */
@@ -24,8 +30,9 @@ export declare function selectTools(options?: McpOptions): McpTool[];
 /**
  * Runs the provided handler with the given client and arguments.
  */
-export declare function executeHandler(handler: HandlerFunction, client: ImageKit, args: Record<string, unknown> | undefined): Promise<import("./types").ToolCallResult>;
-export declare const readEnv: (env: string) => string | undefined;
-export declare const readEnvOrError: (env: string) => string;
-export declare const requireValue: <T>(value: T | undefined, description: string) => T;
+export declare function executeHandler({ handler, reqContext, args, }: {
+    handler: HandlerFunction;
+    reqContext: McpRequestContext;
+    args: Record<string, unknown> | undefined;
+}): Promise<ToolCallResult>;
 //# sourceMappingURL=server.d.ts.map

package/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["src/server.ts"],"names":[],"mappings":"OAEO,EAAE,MAAM,EAAE,MAAM,2CAA2C;OAC3D,EAAE,SAAS,EAAE,MAAM,yCAAyC;OAM5D,EAAE,aAAa,EAAE,MAAM,kBAAkB;OACzC,QAAQ,MAAM,kBAAkB;OAGhC,EAAE,UAAU,EAAE;OACd,EAAE,eAAe,EAAE,OAAO,EAAE;OAE5B,EAAE,UAAU,EAAE;OACd,EAAE,aAAa,EAAE,MAAM,kBAAkB;AAEhD,eAAO,MAAM,YAAY,iBAOtB,CAAC;AAGJ,eAAO,MAAM,MAAM,WAAiB,CAAC;AAErC;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE;IACpC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB,QAoEA;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,EAAE,CAM3D;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,QAAQ,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,6CAG1C;AAED,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,SAO9C,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,KAAK,MAAM,KAAG,MAM5C,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,CAAC,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,aAAa,MAAM,KAAG,CAK3E,CAAC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["src/server.ts"],"names":[],"mappings":"OAEO,EAAE,MAAM,EAAE,MAAM,2CAA2C;OAC3D,EAAE,SAAS,EAAE,MAAM,yCAAyC;OAM5D,EAAE,aAAa,EAAE,MAAM,kBAAkB;OAOzC,EAAE,UAAU,EAAE;OAEd,EAAE,eAAe,EAAE,iBAAiB,EAAE,cAAc,EAAE,OAAO,EAAE;AAEtE,eAAO,MAAM,YAAY,GAAU,8CAGhC;IACD,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,sBAAsB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7C,uBAUE,CAAC;AAEJ;;;GAGG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE;IAC1C,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACxD,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,aAAa,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;CAC/D,iBA0HA;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,EAAE,CAe3D;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,EACnC,OAAO,EACP,UAAU,EACV,IAAI,GACL,EAAE;IACD,OAAO,EAAE,eAAe,CAAC;IACzB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAC3C,GAAG,OAAO,CAAC,cAAc,CAAC,CAE1B"}

package/server.js

@@ -4,7 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.requireValue = exports.readEnvOrError = exports.readEnv = exports.server = exports.newMcpServer = void 0;
+exports.newMcpServer = void 0;
 exports.initMcpServer = initMcpServer;
 exports.selectTools = selectTools;
 exports.executeHandler = executeHandler;
@@ -13,18 +13,23 @@ const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
 const nodejs_1 = __importDefault(require("@imagekit/nodejs"));
 const code_tool_1 = require("./code-tool.js");
 const docs_search_tool_1 = __importDefault(require("./docs-search-tool.js"));
-const newMcpServer = () => new mcp_js_1.McpServer({
+const docs_search_tool_2 = require("./docs-search-tool.js");
+const local_docs_search_1 = require("./local-docs-search.js");
+const instructions_1 = require("./instructions.js");
+const methods_1 = require("./methods.js");
+const newMcpServer = async ({ stainlessApiKey, customInstructionsPath, }) => new mcp_js_1.McpServer({
     name: 'imagekit_nodejs_api',
-    version: '7.3.0',
-}, { capabilities: { tools: {}, logging: {} } });
+    version: '7.4.0',
+}, {
+    instructions: await (0, instructions_1.getInstructions)({ stainlessApiKey, customInstructionsPath }),
+    capabilities: { tools: {}, logging: {} },
+});
 exports.newMcpServer = newMcpServer;
-// Create server instance
-exports.server = (0, exports.newMcpServer)();
 /**
  * Initializes the provided MCP Server with the given tools and handlers.
  * If not provided, the default client, tools and handlers will be used.
  */
-function initMcpServer(params) {
+async function initMcpServer(params) {
     const server = params.server instanceof mcp_js_1.McpServer ? params.server.server : params.server;
     const logAtLevel = (level) => (message, ...rest) => {
         void server.sendLoggingMessage({
@@ -38,14 +43,38 @@ function initMcpServer(params) {
         warn: logAtLevel('warning'),
         error: logAtLevel('error'),
     };
-    let client = new nodejs_1.default({
-        logger,
-        ...params.clientOptions,
-        defaultHeaders: {
-            ...params.clientOptions?.defaultHeaders,
-            'X-Stainless-MCP': 'true',
-        },
-    });
+    if (params.mcpOptions?.docsSearchMode === 'local') {
+        const docsDir = params.mcpOptions?.docsDir;
+        const localSearch = await local_docs_search_1.LocalDocsSearch.create(docsDir ? { docsDir } : undefined);
+        (0, docs_search_tool_2.setLocalSearch)(localSearch);
+    }
+    let _client;
+    let _clientError;
+    let _logLevel;
+    const getClient = () => {
+        if (_clientError)
+            throw _clientError;
+        if (!_client) {
+            try {
+                _client = new nodejs_1.default({
+                    logger,
+                    ...params.clientOptions,
+                    defaultHeaders: {
+                        ...params.clientOptions?.defaultHeaders,
+                        'X-Stainless-MCP': 'true',
+                    },
+                });
+                if (_logLevel) {
+                    _client = _client.withOptions({ logLevel: _logLevel });
+                }
+            }
+            catch (e) {
+                _clientError = e instanceof Error ? e : new Error(String(e));
+                throw _clientError;
+            }
+        }
+        return _client;
+    };
     const providedTools = selectTools(params.mcpOptions);
     const toolMap = Object.fromEntries(providedTools.map((mcpTool) => [mcpTool.tool.name, mcpTool]));
     server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
@@ -59,28 +88,58 @@ function initMcpServer(params) {
         if (!mcpTool) {
             throw new Error(`Unknown tool: ${name}`);
         }
-        return executeHandler(mcpTool.handler, client, args);
+        let client;
+        try {
+            client = getClient();
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to initialize client: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        return executeHandler({
+            handler: mcpTool.handler,
+            reqContext: {
+                client,
+                stainlessApiKey: params.stainlessApiKey ?? params.mcpOptions?.stainlessApiKey,
+                upstreamClientEnvs: params.upstreamClientEnvs,
+                mcpSessionId: params.mcpSessionId,
+                mcpClientInfo: params.mcpClientInfo,
+            },
+            args,
+        });
     });
     server.setRequestHandler(types_js_1.SetLevelRequestSchema, async (request) => {
         const { level } = request.params;
+        let logLevel;
         switch (level) {
             case 'debug':
-                client = client.withOptions({ logLevel: 'debug' });
+                logLevel = 'debug';
                 break;
             case 'info':
-                client = client.withOptions({ logLevel: 'info' });
+                logLevel = 'info';
                 break;
             case 'notice':
             case 'warning':
-                client = client.withOptions({ logLevel: 'warn' });
+                logLevel = 'warn';
                 break;
             case 'error':
-                client = client.withOptions({ logLevel: 'error' });
+                logLevel = 'error';
                 break;
             default:
-                client = client.withOptions({ logLevel: 'off' });
+                logLevel = 'off';
                 break;
         }
+        _logLevel = logLevel;
+        if (_client) {
+            _client = _client.withOptions({ logLevel });
+        }
         return {};
     });
 }
@@ -88,7 +147,13 @@ function initMcpServer(params) {
  * Selects the tools to include in the MCP Server based on the provided options.
  */
 function selectTools(options) {
-    const includedTools = [(0, code_tool_1.codeTool)()];
+    const includedTools = [];
+    if (options?.includeCodeTool ?? true) {
+        includedTools.push((0, code_tool_1.codeTool)({
+            blockedMethods: (0, methods_1.blockedMethodsForCodeTool)(options),
+            codeExecutionMode: options?.codeExecutionMode ?? 'stainless-sandbox',
+        }));
+    }
     if (options?.includeDocsTools ?? true) {
         includedTools.push(docs_search_tool_1.default);
     }
@@ -97,32 +162,7 @@ function selectTools(options) {
 /**
  * Runs the provided handler with the given client and arguments.
  */
-async function executeHandler(handler, client, args) {
-    return await handler(client, args || {});
+async function executeHandler({ handler, reqContext, args, }) {
+    return await handler({ reqContext, args: args || {} });
 }
-const readEnv = (env) => {
-    if (typeof globalThis.process !== 'undefined') {
-        return globalThis.process.env?.[env]?.trim();
-    }
-    else if (typeof globalThis.Deno !== 'undefined') {
-        return globalThis.Deno.env?.get?.(env)?.trim();
-    }
-    return;
-};
-exports.readEnv = readEnv;
-const readEnvOrError = (env) => {
-    let envValue = (0, exports.readEnv)(env);
-    if (envValue === undefined) {
-        throw new Error(`Environment variable ${env} is not set`);
-    }
-    return envValue;
-};
-exports.readEnvOrError = readEnvOrError;
-const requireValue = (value, description) => {
-    if (value === undefined) {
-        throw new Error(`Missing required value: ${description}`);
-    }
-    return value;
-};
-exports.requireValue = requireValue;
 //# sourceMappingURL=server.js.map