@ai-sdk/mcp 0.0.1 → 0.0.3

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @ai-sdk/mcp
 
+## 0.0.3
+
+### Patch Changes
+
+- f796ddc: feat(mcp): adding resources support to MCP client
+
+## 0.0.2
+
+### Patch Changes
+
+- Updated dependencies [1e05490]
+  - @ai-sdk/provider-utils@3.0.13
+
 ## 0.0.1
 
 ### Patch Changes

package/dist/index.d.mts

@@ -254,6 +254,40 @@ type McpToolSet<TOOL_SCHEMAS extends ToolSchemas = 'automatic'> = TOOL_SCHEMAS e
 } : McpToolSet<Record<string, {
     inputSchema: FlexibleSchema<unknown>;
 }>>;
+declare const BaseParamsSchema: z.ZodObject<{
+    _meta: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+}, z.core.$loose>;
+type BaseParams = z.infer<typeof BaseParamsSchema>;
+declare const RequestSchema: z.ZodObject<{
+    method: z.ZodString;
+    params: z.ZodOptional<z.ZodObject<{
+        _meta: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+    }, z.core.$loose>>;
+}, z.core.$strip>;
+type Request = z.infer<typeof RequestSchema>;
+type RequestOptions = {
+    signal?: AbortSignal;
+    timeout?: number;
+    maxTotalTimeout?: number;
+};
+type PaginatedRequest = Request & {
+    params?: BaseParams & {
+        cursor?: string;
+    };
+};
+declare const ListResourcesResultSchema: z.ZodObject<{
+    _meta: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+    nextCursor: z.ZodOptional<z.ZodString>;
+    resources: z.ZodArray<z.ZodObject<{
+        uri: z.ZodString;
+        name: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+type ListResourcesResult = z.infer<typeof ListResourcesResultSchema>;
 declare const CallToolResultSchema: z.ZodUnion<[z.ZodObject<{
     _meta: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
     content: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
@@ -267,10 +301,14 @@ declare const CallToolResultSchema: z.ZodUnion<[z.ZodObject<{
         type: z.ZodLiteral<"resource">;
         resource: z.ZodUnion<readonly [z.ZodObject<{
             uri: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
             mimeType: z.ZodOptional<z.ZodString>;
             text: z.ZodString;
         }, z.core.$loose>, z.ZodObject<{
             uri: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
             mimeType: z.ZodOptional<z.ZodString>;
             blob: z.ZodBase64;
         }, z.core.$loose>]>;
@@ -281,6 +319,34 @@ declare const CallToolResultSchema: z.ZodUnion<[z.ZodObject<{
     toolResult: z.ZodUnknown;
 }, z.core.$loose>]>;
 type CallToolResult = z.infer<typeof CallToolResultSchema>;
+declare const ListResourceTemplatesResultSchema: z.ZodObject<{
+    _meta: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+    resourceTemplates: z.ZodArray<z.ZodObject<{
+        uriTemplate: z.ZodString;
+        name: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+type ListResourceTemplatesResult = z.infer<typeof ListResourceTemplatesResultSchema>;
+declare const ReadResourceResultSchema: z.ZodObject<{
+    _meta: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+    contents: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        uri: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+        text: z.ZodString;
+    }, z.core.$loose>, z.ZodObject<{
+        uri: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+        blob: z.ZodBase64;
+    }, z.core.$loose>]>>;
+}, z.core.$loose>;
+type ReadResourceResult = z.infer<typeof ReadResourceResultSchema>;
 
 interface MCPClientConfig {
     /** Transport configuration for connecting to the MCP server */
@@ -295,6 +361,17 @@ interface MCPClient {
     tools<TOOL_SCHEMAS extends ToolSchemas = 'automatic'>(options?: {
         schemas?: TOOL_SCHEMAS;
     }): Promise<McpToolSet<TOOL_SCHEMAS>>;
+    listResources(options?: {
+        params?: PaginatedRequest['params'];
+        options?: RequestOptions;
+    }): Promise<ListResourcesResult>;
+    readResource(args: {
+        uri: string;
+        options?: RequestOptions;
+    }): Promise<ReadResourceResult>;
+    listResourceTemplates(options?: {
+        options?: RequestOptions;
+    }): Promise<ListResourceTemplatesResult>;
     close: () => Promise<void>;
 }
 

package/dist/index.d.ts

@@ -254,6 +254,40 @@ type McpToolSet<TOOL_SCHEMAS extends ToolSchemas = 'automatic'> = TOOL_SCHEMAS e
 } : McpToolSet<Record<string, {
     inputSchema: FlexibleSchema<unknown>;
 }>>;
+declare const BaseParamsSchema: z.ZodObject<{
+    _meta: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+}, z.core.$loose>;
+type BaseParams = z.infer<typeof BaseParamsSchema>;
+declare const RequestSchema: z.ZodObject<{
+    method: z.ZodString;
+    params: z.ZodOptional<z.ZodObject<{
+        _meta: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+    }, z.core.$loose>>;
+}, z.core.$strip>;
+type Request = z.infer<typeof RequestSchema>;
+type RequestOptions = {
+    signal?: AbortSignal;
+    timeout?: number;
+    maxTotalTimeout?: number;
+};
+type PaginatedRequest = Request & {
+    params?: BaseParams & {
+        cursor?: string;
+    };
+};
+declare const ListResourcesResultSchema: z.ZodObject<{
+    _meta: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+    nextCursor: z.ZodOptional<z.ZodString>;
+    resources: z.ZodArray<z.ZodObject<{
+        uri: z.ZodString;
+        name: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+type ListResourcesResult = z.infer<typeof ListResourcesResultSchema>;
 declare const CallToolResultSchema: z.ZodUnion<[z.ZodObject<{
     _meta: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
     content: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
@@ -267,10 +301,14 @@ declare const CallToolResultSchema: z.ZodUnion<[z.ZodObject<{
         type: z.ZodLiteral<"resource">;
         resource: z.ZodUnion<readonly [z.ZodObject<{
             uri: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
             mimeType: z.ZodOptional<z.ZodString>;
             text: z.ZodString;
         }, z.core.$loose>, z.ZodObject<{
             uri: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
             mimeType: z.ZodOptional<z.ZodString>;
             blob: z.ZodBase64;
         }, z.core.$loose>]>;
@@ -281,6 +319,34 @@ declare const CallToolResultSchema: z.ZodUnion<[z.ZodObject<{
     toolResult: z.ZodUnknown;
 }, z.core.$loose>]>;
 type CallToolResult = z.infer<typeof CallToolResultSchema>;
+declare const ListResourceTemplatesResultSchema: z.ZodObject<{
+    _meta: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+    resourceTemplates: z.ZodArray<z.ZodObject<{
+        uriTemplate: z.ZodString;
+        name: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+type ListResourceTemplatesResult = z.infer<typeof ListResourceTemplatesResultSchema>;
+declare const ReadResourceResultSchema: z.ZodObject<{
+    _meta: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+    contents: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        uri: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+        text: z.ZodString;
+    }, z.core.$loose>, z.ZodObject<{
+        uri: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+        blob: z.ZodBase64;
+    }, z.core.$loose>]>>;
+}, z.core.$loose>;
+type ReadResourceResult = z.infer<typeof ReadResourceResultSchema>;
 
 interface MCPClientConfig {
     /** Transport configuration for connecting to the MCP server */
@@ -295,6 +361,17 @@ interface MCPClient {
     tools<TOOL_SCHEMAS extends ToolSchemas = 'automatic'>(options?: {
         schemas?: TOOL_SCHEMAS;
     }): Promise<McpToolSet<TOOL_SCHEMAS>>;
+    listResources(options?: {
+        params?: PaginatedRequest['params'];
+        options?: RequestOptions;
+    }): Promise<ListResourcesResult>;
+    readResource(args: {
+        uri: string;
+        options?: RequestOptions;
+    }): Promise<ReadResourceResult>;
+    listResourceTemplates(options?: {
+        options?: RequestOptions;
+    }): Promise<ListResourceTemplatesResult>;
     close: () => Promise<void>;
 }
 

package/dist/index.js

@@ -138,11 +138,30 @@ var ImageContentSchema = import_v4.z.object({
   data: import_v4.z.base64(),
   mimeType: import_v4.z.string()
 }).loose();
+var ResourceSchema = import_v4.z.object({
+  uri: import_v4.z.string(),
+  name: import_v4.z.string(),
+  title: import_v4.z.optional(import_v4.z.string()),
+  description: import_v4.z.optional(import_v4.z.string()),
+  mimeType: import_v4.z.optional(import_v4.z.string()),
+  size: import_v4.z.optional(import_v4.z.number())
+}).loose();
+var ListResourcesResultSchema = PaginatedResultSchema.extend({
+  resources: import_v4.z.array(ResourceSchema)
+});
 var ResourceContentsSchema = import_v4.z.object({
   /**
    * The URI of this resource.
    */
   uri: import_v4.z.string(),
+  /**
+   * Optional display name of the resource content.
+   */
+  name: import_v4.z.optional(import_v4.z.string()),
+  /**
+   * Optional human readable title.
+   */
+  title: import_v4.z.optional(import_v4.z.string()),
   /**
    * The MIME type of this resource, if known.
    */
@@ -168,6 +187,21 @@ var CallToolResultSchema = ResultSchema.extend({
     toolResult: import_v4.z.unknown()
   })
 );
+var ResourceTemplateSchema = import_v4.z.object({
+  uriTemplate: import_v4.z.string(),
+  name: import_v4.z.string(),
+  title: import_v4.z.optional(import_v4.z.string()),
+  description: import_v4.z.optional(import_v4.z.string()),
+  mimeType: import_v4.z.optional(import_v4.z.string())
+}).loose();
+var ListResourceTemplatesResultSchema = ResultSchema.extend({
+  resourceTemplates: import_v4.z.array(ResourceTemplateSchema)
+});
+var ReadResourceResultSchema = ResultSchema.extend({
+  contents: import_v4.z.array(
+    import_v4.z.union([TextResourceContentsSchema, BlobResourceContentsSchema])
+  )
+});
 
 // src/tool/json-rpc-message.ts
 var JSONRPC_VERSION = "2.0";
@@ -1569,6 +1603,15 @@ var DefaultMCPClient = class {
           });
         }
         break;
+      case "resources/list":
+      case "resources/read":
+      case "resources/templates/list":
+        if (!this.serverCapabilities.resources) {
+          throw new MCPClientError({
+            message: `Server does not support resources`
+          });
+        }
+        break;
       default:
         throw new MCPClientError({
           message: `Unsupported method: ${method}`
@@ -1660,6 +1703,47 @@ var DefaultMCPClient = class {
       throw error;
     }
   }
+  async listResourcesInternal({
+    params,
+    options
+  } = {}) {
+    try {
+      return this.request({
+        request: { method: "resources/list", params },
+        resultSchema: ListResourcesResultSchema,
+        options
+      });
+    } catch (error) {
+      throw error;
+    }
+  }
+  async readResourceInternal({
+    uri,
+    options
+  }) {
+    try {
+      return this.request({
+        request: { method: "resources/read", params: { uri } },
+        resultSchema: ReadResourceResultSchema,
+        options
+      });
+    } catch (error) {
+      throw error;
+    }
+  }
+  async listResourceTemplatesInternal({
+    options
+  } = {}) {
+    try {
+      return this.request({
+        request: { method: "resources/templates/list" },
+        resultSchema: ListResourceTemplatesResultSchema,
+        options
+      });
+    } catch (error) {
+      throw error;
+    }
+  }
   async notification(notification) {
     const jsonrpcNotification = {
       ...notification,
@@ -1708,6 +1792,23 @@ var DefaultMCPClient = class {
       throw error;
     }
   }
+  listResources({
+    params,
+    options
+  } = {}) {
+    return this.listResourcesInternal({ params, options });
+  }
+  readResource({
+    uri,
+    options
+  }) {
+    return this.readResourceInternal({ uri, options });
+  }
+  listResourceTemplates({
+    options
+  } = {}) {
+    return this.listResourceTemplatesInternal({ options });
+  }
   onClose() {
     if (this.isClosed) return;
     this.isClosed = true;