@mcp-use/client 2.2.5 → 2.3.0

package/dist/adapters/ai-sdk.d.ts

@@ -0,0 +1,98 @@
+import type { CallToolResult, Tool as MCPTool } from "@modelcontextprotocol/client";
+import type { MCPConnection } from "../core/session.js";
+/** The input shape passed to an MCP tool by the AI SDK. */
+export type AiSdkToolInput = Record<string, unknown>;
+/** The unmodified MCP result returned from a tool execution. */
+export type AiSdkToolOutput = CallToolResult;
+/** The JSON-schema view passed to the optional schema transformer. */
+export type AiSdkInputSchema = Record<string, unknown>;
+/** A successful pass-through result for an AI SDK dynamic-tool input. */
+export interface AiSdkToolValidationResult {
+    /** Confirms that the adapter leaves validation to the MCP server. */
+    success: true;
+    /** The parsed value passed through to MCP without local schema coercion. */
+    value: unknown;
+}
+/**
+ * A JSON Schema wrapper understood by AI SDK dynamic tools.
+ *
+ * It uses AI SDK's runtime schema and validator markers without importing an
+ * AI SDK package. The pass-through validator keeps MCP servers authoritative
+ * for input validation while supporting AI SDK v5's validator path.
+ */
+export interface AiSdkToolSchema {
+    /** AI SDK schema type placeholder for runtime-discovered tool inputs. */
+    _type: undefined;
+    /** The unmodified MCP JSON Schema sent to the AI SDK provider. */
+    jsonSchema: AiSdkInputSchema;
+    /** Accepts parsed JSON; the MCP server performs authoritative validation. */
+    validate(value: unknown): AiSdkToolValidationResult;
+}
+/** Execution context supplied by supported AI SDK dynamic-tool versions. */
+export interface AiSdkToolExecutionOptions {
+    /** Cancels the corresponding MCP request when the AI SDK aborts it. */
+    abortSignal?: AbortSignal;
+}
+/**
+ * An AI SDK dynamic tool backed by an MCP tool.
+ *
+ * The `annotations`, `_meta`, and `metadata` fields are retained as MCP-side
+ * metadata. The structural type intentionally imports no AI SDK types so the
+ * client remains compatible with AI SDK v5, v6, and v7 without a dependency.
+ */
+export interface AiSdkTool {
+    /** Identifies this as an AI SDK runtime-generated tool. */
+    type: "dynamic";
+    /** MCP tool description supplied to the model, when present. */
+    description?: string;
+    /** Human-readable MCP tool title, when present. */
+    title?: string;
+    /**
+     * Input schema passed to the AI SDK provider and dynamic-tool parser.
+     *
+     * `any` is intentional: AI SDK v5, v6, and v7 expose incompatible
+     * `FlexibleSchema` generations, while dynamic MCP tool inputs are runtime
+     * values in all of them.
+     */
+    inputSchema: any;
+    /** Executes the MCP tool with model-provided arguments. */
+    execute(args: unknown, executionOptions?: AiSdkToolExecutionOptions): Promise<AiSdkToolOutput>;
+    /** Original MCP tool annotations. */
+    annotations?: MCPTool["annotations"];
+    /** Original MCP tool metadata. */
+    _meta?: MCPTool["_meta"];
+    /** Adapter metadata retained for AI SDK/provider consumers. */
+    metadata?: any;
+}
+/** A source with the protocol-neutral MCP operations needed by the adapter. */
+export type AiSdkToolConnection = Pick<MCPConnection, "listTools" | "callTool">;
+/** Options controlling MCP tool discovery, schema normalization, and metadata. */
+export interface CreateAiSdkToolsOptions {
+    /**
+     * Tool definitions to adapt. When omitted, the adapter fetches them with
+     * `connection.listTools()`. An explicitly supplied empty array is valid and
+     * does not trigger discovery.
+     */
+    tools?: MCPTool[];
+    /**
+     * Transforms the MCP input schema before it is passed to the AI SDK. The
+     * returned schema is preserved exactly; use this only for deliberate
+     * application-level compatibility transformations.
+     */
+    transformInputSchema?: (inputSchema: unknown) => unknown;
+    /**
+     * Client identity retained in the returned tool metadata. This does not
+     * change the already-connected MCP connection's client identity.
+     */
+    clientName?: string;
+}
+/** The AI SDK tools keyed by their original MCP tool names. */
+export type AiSdkToolSet = Record<string, AiSdkTool>;
+/**
+ * Creates AI SDK dynamic tools from one protocol-neutral MCP connection.
+ *
+ * This helper adapts tool definitions and invocation only. It does not own
+ * connection creation, authentication, transport lifetime, or cleanup.
+ */
+export declare function createAiSdkTools(connection: AiSdkToolConnection, options?: CreateAiSdkToolsOptions): Promise<AiSdkToolSet>;
+//# sourceMappingURL=ai-sdk.d.ts.map

package/dist/adapters/ai-sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-sdk.d.ts","sourceRoot":"","sources":["../../src/adapters/ai-sdk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,IAAI,IAAI,OAAO,EAChB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAKxD,2DAA2D;AAC3D,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAErD,gEAAgE;AAChE,MAAM,MAAM,eAAe,GAAG,cAAc,CAAC;AAE7C,sEAAsE;AACtE,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEvD,yEAAyE;AACzE,MAAM,WAAW,yBAAyB;IACxC,qEAAqE;IACrE,OAAO,EAAE,IAAI,CAAC;IACd,4EAA4E;IAC5E,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,KAAK,EAAE,SAAS,CAAC;IACjB,kEAAkE;IAClE,UAAU,EAAE,gBAAgB,CAAC;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,yBAAyB,CAAC;CACrD;AAED,4EAA4E;AAC5E,MAAM,WAAW,yBAAyB;IACxC,uEAAuE;IACvE,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB,2DAA2D;IAC3D,IAAI,EAAE,SAAS,CAAC;IAChB,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;OAMG;IACH,WAAW,EAAE,GAAG,CAAC;IACjB,2DAA2D;IAC3D,OAAO,CACL,IAAI,EAAE,OAAO,EACb,gBAAgB,CAAC,EAAE,yBAAyB,GAC3C,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5B,qCAAqC;IACrC,WAAW,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACrC,kCAAkC;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACzB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,GAAG,CAAC;CAChB;AAED,+EAA+E;AAC/E,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,aAAa,EAAE,WAAW,GAAG,UAAU,CAAC,CAAC;AAEhF,kFAAkF;AAClF,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,CAAC,WAAW,EAAE,OAAO,KAAK,OAAO,CAAC;IACzD;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,+DAA+D;AAC/D,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAErD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,mBAAmB,EAC/B,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,YAAY,CAAC,CA+DvB"}

package/dist/index-browser.d.ts

@@ -15,6 +15,7 @@ export { auth, UnauthorizedError } from "@modelcontextprotocol/client";
 export { BrowserMCPClient as MCPClient } from "./core/browser.js";
 export * from "./core/session.js";
 export * from "./core/config.js";
+export * from "./adapters/ai-sdk.js";
 export * from "./transport/base.js";
 export * from "./transport/http.js";
 export * from "./utils/json-schema-validator.js";

package/dist/index-browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index-browser.d.ts","sourceRoot":"","sources":["../src/index-browser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,kCAAkC,CAAC;AAE1C,OAAO,EACL,mBAAmB,EACnB,KAAK,oBAAoB,GAC1B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,0BAA0B,EAC1B,KAAK,mBAAmB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACvE,sDAAsD;AACtD,OAAO,EAAE,gBAAgB,IAAI,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAClE,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AAEjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kCAAkC,CAAC;AAEjD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EACL,GAAG,EACH,SAAS,EACT,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,eAAe,GAChB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index-browser.d.ts","sourceRoot":"","sources":["../src/index-browser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,kCAAkC,CAAC;AAE1C,OAAO,EACL,mBAAmB,EACnB,KAAK,oBAAoB,GAC1B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,0BAA0B,EAC1B,KAAK,mBAAmB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACvE,sDAAsD;AACtD,OAAO,EAAE,gBAAgB,IAAI,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAClE,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AAErC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kCAAkC,CAAC;AAEjD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EACL,GAAG,EACH,SAAS,EACT,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,eAAe,GAChB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index-browser.js

@@ -128,7 +128,7 @@ var Logger = class {
 var logger = Logger.get();
 
 // src/utils/version.ts
-var VERSION = "2.2.5";
+var VERSION = "2.3.0";
 function getPackageVersion() {
   return VERSION;
 }
@@ -4661,6 +4661,72 @@ var BrowserMCPClient = class _BrowserMCPClient extends BaseMCPClient {
   }
 };
 
+// src/adapters/ai-sdk.ts
+var AI_SDK_SCHEMA_SYMBOL = /* @__PURE__ */ Symbol.for("vercel.ai.schema");
+var AI_SDK_VALIDATOR_SYMBOL = /* @__PURE__ */ Symbol.for("vercel.ai.validator");
+async function createAiSdkTools(connection, options = {}) {
+  const tools = options.tools ?? await connection.listTools();
+  const result = /* @__PURE__ */ Object.create(null);
+  for (const mcpTool of tools) {
+    const name = mcpTool.name;
+    if (Object.prototype.hasOwnProperty.call(result, name)) {
+      throw new Error(`Duplicate MCP tool name: ${name}`);
+    }
+    const rawInputSchema = mcpTool.inputSchema;
+    const transformedInputSchema = options.transformInputSchema?.(rawInputSchema) ?? rawInputSchema;
+    const inputSchema = toAiSdkInputSchema(
+      asInputSchema(transformedInputSchema)
+    );
+    const title = mcpTool.title ?? mcpTool.annotations?.title;
+    const metadata = {
+      toolName: name,
+      ...options.clientName !== void 0 ? { clientName: options.clientName } : {},
+      ...title !== void 0 ? { title } : {},
+      ...mcpTool.annotations !== void 0 ? { annotations: mcpTool.annotations } : {},
+      ...mcpTool._meta !== void 0 ? { _meta: mcpTool._meta } : {}
+    };
+    const execute = async (args, executionOptions = {}) => {
+      executionOptions?.abortSignal?.throwIfAborted();
+      return connection.callTool(name, args, {
+        signal: executionOptions?.abortSignal
+      });
+    };
+    const dynamicDefinition = {
+      type: "dynamic",
+      ...mcpTool.description !== void 0 ? { description: mcpTool.description } : {},
+      ...title !== void 0 ? { title } : {},
+      inputSchema,
+      execute,
+      metadata,
+      ...mcpTool.annotations !== void 0 ? { annotations: mcpTool.annotations } : {},
+      ...mcpTool._meta !== void 0 ? { _meta: mcpTool._meta } : {}
+    };
+    Object.defineProperty(result, name, {
+      configurable: true,
+      enumerable: true,
+      value: dynamicDefinition,
+      writable: true
+    });
+  }
+  return result;
+}
+function asInputSchema(schema) {
+  if (schema && typeof schema === "object" && !Array.isArray(schema)) {
+    return schema;
+  }
+  return {};
+}
+function toAiSdkInputSchema(jsonSchema) {
+  const schema = {
+    [AI_SDK_SCHEMA_SYMBOL]: true,
+    [AI_SDK_VALIDATOR_SYMBOL]: true,
+    _type: void 0,
+    jsonSchema,
+    validate: (value) => ({ success: true, value })
+  };
+  return schema;
+}
+
 // src/utils/favicon.ts
 var FAVICON_API = "https://favicon.tools.mcp-use.com";
 var IPV4_RE = /^\d{1,3}(\.\d{1,3}){3}$/;
@@ -4748,6 +4814,7 @@ export {
   auth2 as auth,
   capturePostHog,
   completeOAuthFlow,
+  createAiSdkTools,
   createConnectorFromConfig,
   createOAuthProvider,
   detectFavicon,