@a1st/mcp-registry-client 0.0.3

package/dist/client.d.ts

@@ -0,0 +1,90 @@
+import type { ServerListResponse, ServerResponse, ListServersOptions, ErrorResponse } from './types.js';
+/** Default base URL for the official MCP Registry */
+export declare const DEFAULT_BASE_URL = "https://registry.modelcontextprotocol.io";
+/** Error thrown when the MCP Registry API returns an error */
+export declare class McpRegistryError extends Error {
+    readonly status: number;
+    readonly response?: ErrorResponse | undefined;
+    constructor(message: string, status: number, response?: ErrorResponse | undefined);
+}
+/** Options for creating an MCP Registry client */
+export interface McpRegistryClientOptions {
+    /** Base URL for the registry API (defaults to official registry) */
+    baseUrl?: string;
+    /** Custom fetch implementation (defaults to global fetch) */
+    fetch?: typeof fetch;
+}
+/**
+ * Client for the official MCP Registry API.
+ *
+ * @example
+ * ```ts
+ * const client = new McpRegistryClient();
+ *
+ * // Search for servers
+ * const results = await client.search('playwright');
+ *
+ * // Get a specific server
+ * const server = await client.getServer('io.github.user/my-server');
+ *
+ * // List all servers with pagination
+ * for await (const server of client.listAll()) {
+ *   console.log(server.server.name);
+ * }
+ * ```
+ */
+export declare class McpRegistryClient {
+    private readonly baseUrl;
+    private readonly fetch;
+    constructor(options?: McpRegistryClientOptions);
+    /**
+     * List servers from the registry with optional filtering.
+     *
+     * @param options - Filtering and pagination options
+     * @returns A page of server results with pagination metadata
+     */
+    list(options?: ListServersOptions): Promise<ServerListResponse>;
+    /**
+     * Search for servers by name.
+     * Convenience method that wraps `list()` with search and version=latest.
+     *
+     * @param query - Search query (substring match on server names)
+     * @param options - Additional filtering options
+     * @returns A page of matching server results
+     */
+    search(query: string, options?: Omit<ListServersOptions, 'search'>): Promise<ServerListResponse>;
+    /**
+     * Get all versions of a specific server.
+     *
+     * @param serverName - Server name in reverse-DNS format (e.g., 'io.github.user/my-server')
+     * @returns List of all versions for the server
+     */
+    getServerVersions(serverName: string): Promise<ServerListResponse>;
+    /**
+     * Get a specific version of a server.
+     *
+     * @param serverName - Server name in reverse-DNS format (e.g., 'io.github.user/my-server')
+     * @param version - Version string or 'latest' for the latest version
+     * @returns The server configuration and metadata
+     */
+    getServer(serverName: string, version?: string): Promise<ServerResponse>;
+    /**
+     * Iterate over all servers in the registry with automatic pagination.
+     *
+     * @param options - Filtering options (cursor is managed automatically)
+     * @yields Server responses one at a time
+     *
+     * @example
+     * ```ts
+     * for await (const server of client.listAll({ version: 'latest' })) {
+     *   console.log(server.server.name);
+     * }
+     * ```
+     */
+    listAll(options?: Omit<ListServersOptions, 'cursor'>): AsyncGenerator<ServerResponse, void, unknown>;
+    /**
+     * Make a request to the registry API.
+     */
+    private request;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAExG,qDAAqD;AACrD,eAAO,MAAM,gBAAgB,6CAA6C,CAAC;AAK3E,8DAA8D;AAC9D,qBAAa,gBAAiB,SAAQ,KAAK;aAGrB,MAAM,EAAE,MAAM;aACd,QAAQ,CAAC,EAAE,aAAa;gBAFxC,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,aAAa,YAAA;CAK7C;AAED,kDAAkD;AAClD,MAAM,WAAW,wBAAwB;IACtC,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,iBAAiB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;gBAEzB,OAAO,GAAE,wBAA6B;IAKlD;;;;;OAKG;IACG,IAAI,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAyBzE;;;;;;;OAOG;IACG,MAAM,CACT,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,IAAI,CAAC,kBAAkB,EAAE,QAAQ,CAAM,GAChD,OAAO,CAAC,kBAAkB,CAAC;IAQ9B;;;;;OAKG;IACG,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAOxE;;;;;;OAMG;IACG,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,SAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IAQhF;;;;;;;;;;;;OAYG;IACI,OAAO,CACX,OAAO,GAAE,IAAI,CAAC,kBAAkB,EAAE,QAAQ,CAAM,GAChD,cAAc,CAAC,cAAc,EAAE,IAAI,EAAE,OAAO,CAAC;IAiBhD;;OAEG;YACW,OAAO;CAuBvB"}

package/dist/client.js

@@ -0,0 +1,157 @@
+/** Default base URL for the official MCP Registry */
+export const DEFAULT_BASE_URL = 'https://registry.modelcontextprotocol.io';
+/** API version prefix */
+const API_VERSION = 'v0.1';
+/** Error thrown when the MCP Registry API returns an error */
+export class McpRegistryError extends Error {
+    status;
+    response;
+    constructor(message, status, response) {
+        super(message);
+        this.status = status;
+        this.response = response;
+        this.name = 'McpRegistryError';
+    }
+}
+/**
+ * Client for the official MCP Registry API.
+ *
+ * @example
+ * ```ts
+ * const client = new McpRegistryClient();
+ *
+ * // Search for servers
+ * const results = await client.search('playwright');
+ *
+ * // Get a specific server
+ * const server = await client.getServer('io.github.user/my-server');
+ *
+ * // List all servers with pagination
+ * for await (const server of client.listAll()) {
+ *   console.log(server.server.name);
+ * }
+ * ```
+ */
+export class McpRegistryClient {
+    baseUrl;
+    fetch;
+    constructor(options = {}) {
+        this.baseUrl = options.baseUrl ?? DEFAULT_BASE_URL;
+        this.fetch = options.fetch ?? globalThis.fetch;
+    }
+    /**
+     * List servers from the registry with optional filtering.
+     *
+     * @param options - Filtering and pagination options
+     * @returns A page of server results with pagination metadata
+     */
+    async list(options = {}) {
+        const params = new URLSearchParams();
+        if (options.cursor) {
+            params.set('cursor', options.cursor);
+        }
+        if (options.limit !== undefined) {
+            params.set('limit', String(options.limit));
+        }
+        if (options.updatedSince) {
+            params.set('updated_since', options.updatedSince);
+        }
+        if (options.search) {
+            params.set('search', options.search);
+        }
+        if (options.version) {
+            params.set('version', options.version);
+        }
+        const queryString = params.toString();
+        const url = `${this.baseUrl}/${API_VERSION}/servers${queryString ? `?${queryString}` : ''}`;
+        return this.request(url);
+    }
+    /**
+     * Search for servers by name.
+     * Convenience method that wraps `list()` with search and version=latest.
+     *
+     * @param query - Search query (substring match on server names)
+     * @param options - Additional filtering options
+     * @returns A page of matching server results
+     */
+    async search(query, options = {}) {
+        return this.list({
+            ...options,
+            search: query,
+            version: options.version ?? 'latest',
+        });
+    }
+    /**
+     * Get all versions of a specific server.
+     *
+     * @param serverName - Server name in reverse-DNS format (e.g., 'io.github.user/my-server')
+     * @returns List of all versions for the server
+     */
+    async getServerVersions(serverName) {
+        const encodedName = encodeURIComponent(serverName);
+        const url = `${this.baseUrl}/${API_VERSION}/servers/${encodedName}/versions`;
+        return this.request(url);
+    }
+    /**
+     * Get a specific version of a server.
+     *
+     * @param serverName - Server name in reverse-DNS format (e.g., 'io.github.user/my-server')
+     * @param version - Version string or 'latest' for the latest version
+     * @returns The server configuration and metadata
+     */
+    async getServer(serverName, version = 'latest') {
+        const encodedName = encodeURIComponent(serverName);
+        const encodedVersion = encodeURIComponent(version);
+        const url = `${this.baseUrl}/${API_VERSION}/servers/${encodedName}/versions/${encodedVersion}`;
+        return this.request(url);
+    }
+    /**
+     * Iterate over all servers in the registry with automatic pagination.
+     *
+     * @param options - Filtering options (cursor is managed automatically)
+     * @yields Server responses one at a time
+     *
+     * @example
+     * ```ts
+     * for await (const server of client.listAll({ version: 'latest' })) {
+     *   console.log(server.server.name);
+     * }
+     * ```
+     */
+    async *listAll(options = {}) {
+        let cursor;
+        do {
+            // eslint-disable-next-line no-await-in-loop -- Sequential pagination required
+            const response = await this.list({ ...options, cursor });
+            if (response.servers) {
+                for (const server of response.servers) {
+                    yield server;
+                }
+            }
+            cursor = response.metadata.nextCursor;
+        } while (cursor);
+    }
+    /**
+     * Make a request to the registry API.
+     */
+    async request(url) {
+        const response = await this.fetch(url, {
+            headers: {
+                Accept: 'application/json',
+            },
+        });
+        if (!response.ok) {
+            let errorResponse;
+            try {
+                errorResponse = (await response.json());
+            }
+            catch {
+                // Ignore JSON parse errors for error responses
+            }
+            const message = errorResponse?.detail ?? errorResponse?.title ?? `HTTP ${response.status}`;
+            throw new McpRegistryError(message, response.status, errorResponse);
+        }
+        return response.json();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types.js';
+export * from './client.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from './types.js';
+export * from './client.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,235 @@
+/**
+ * Types for the official MCP Registry API.
+ * Based on the OpenAPI spec at https://registry.modelcontextprotocol.io/openapi.yaml
+ */
+/** Input format types */
+export type InputFormat = 'string' | 'number' | 'boolean' | 'filepath';
+/** Transport types */
+export type TransportType = 'stdio' | 'streamable-http' | 'sse';
+/** Registry types for packages */
+export type RegistryType = 'npm' | 'pypi' | 'oci' | 'nuget' | 'mcpb';
+/** Server lifecycle status */
+export type ServerStatus = 'active' | 'deprecated' | 'deleted';
+/** Icon theme */
+export type IconTheme = 'light' | 'dark';
+/** Icon MIME types */
+export type IconMimeType = 'image/png' | 'image/jpeg' | 'image/jpg' | 'image/svg+xml' | 'image/webp';
+/** Generic input configuration */
+export interface Input {
+    /** A list of possible values for the input */
+    choices?: string[] | null;
+    /** The default value for the input */
+    default?: string;
+    /** A description of the input */
+    description?: string;
+    /** Specifies the input format */
+    format?: InputFormat;
+    /** Whether the input is required */
+    isRequired?: boolean;
+    /** Indicates whether the input is a secret value */
+    isSecret?: boolean;
+    /** A placeholder for the input */
+    placeholder?: string;
+    /** The value for the input */
+    value?: string;
+}
+/** Key-value input (for environment variables and headers) */
+export interface KeyValueInput extends Input {
+    /** Name of the header or environment variable */
+    name: string;
+    /** Variables for value templating */
+    variables?: Record<string, Input>;
+}
+/** Argument configuration */
+export interface Argument {
+    /** Argument type: 'positional' or 'named' */
+    type: string;
+    /** A list of possible values for the input */
+    choices?: string[] | null;
+    /** The default value for the input */
+    default?: string;
+    /** A description of the input */
+    description?: string;
+    /** Specifies the input format */
+    format?: InputFormat;
+    /** Whether the argument can be repeated multiple times */
+    isRepeated?: boolean;
+    /** Whether the input is required */
+    isRequired?: boolean;
+    /** Indicates whether the input is a secret value */
+    isSecret?: boolean;
+    /** The flag name (for named arguments), including any leading dashes */
+    name?: string;
+    /** A placeholder for the input */
+    placeholder?: string;
+    /** The value for the input */
+    value?: string;
+    /** An identifier for positional arguments */
+    valueHint?: string;
+    /** A map of variable names to their values */
+    variables?: Record<string, Input>;
+}
+/** Transport protocol configuration */
+export interface Transport {
+    /** Transport type (stdio, streamable-http, or sse) */
+    type: TransportType;
+    /** URL for streamable-http or sse transports */
+    url?: string;
+    /** HTTP headers for streamable-http or sse transports */
+    headers?: KeyValueInput[] | null;
+    /** Variables for URL templating in remote transports */
+    variables?: Record<string, Input>;
+}
+/** Package configuration */
+export interface Package {
+    /** Registry type indicating how to download packages */
+    registryType: RegistryType;
+    /** Package identifier - either a package name or URL */
+    identifier: string;
+    /** Transport protocol configuration for the package */
+    transport: Transport;
+    /** Package version */
+    version?: string;
+    /** Base URL of the package registry */
+    registryBaseUrl?: string;
+    /** A mapping of environment variables to be set when running the package */
+    environmentVariables?: KeyValueInput[] | null;
+    /** SHA-256 hash of the package file for integrity verification */
+    fileSha256?: string;
+    /** A list of arguments to be passed to the package's binary */
+    packageArguments?: Argument[] | null;
+    /** A list of arguments to be passed to the package's runtime command */
+    runtimeArguments?: Argument[] | null;
+    /** A hint to help clients determine the appropriate runtime for the package */
+    runtimeHint?: string;
+}
+/** Icon configuration */
+export interface Icon {
+    /** A standard URI pointing to an icon resource */
+    src: string;
+    /** Optional MIME type override */
+    mimeType?: IconMimeType;
+    /** Optional array of strings that specify sizes */
+    sizes?: string[] | null;
+    /** Optional specifier for the theme this icon is designed for */
+    theme?: IconTheme;
+}
+/** Repository metadata */
+export interface Repository {
+    /** Repository URL for browsing source code */
+    url?: string;
+    /** Repository hosting service identifier */
+    source?: string;
+    /** Repository identifier from the hosting service */
+    id?: string;
+    /** Optional relative path from repository root to the server location */
+    subfolder?: string;
+}
+/** Publisher-provided metadata */
+export interface ServerMeta {
+    'io.modelcontextprotocol.registry/publisher-provided'?: Record<string, unknown>;
+}
+/** Server JSON configuration */
+export interface ServerJSON {
+    /** JSON Schema URI for this server.json format */
+    $schema: string;
+    /** Server name in reverse-DNS format */
+    name: string;
+    /** Clear human-readable explanation of server functionality */
+    description: string;
+    /** Version string for this server */
+    version: string;
+    /** Optional human-readable title or display name */
+    title?: string;
+    /** Array of package configurations */
+    packages?: Package[] | null;
+    /** Array of remote configurations */
+    remotes?: Transport[] | null;
+    /** Optional repository metadata */
+    repository?: Repository;
+    /** Optional set of sized icons */
+    icons?: Icon[] | null;
+    /** Optional URL to the server's homepage */
+    websiteUrl?: string;
+    /** Extension metadata using reverse DNS namespacing */
+    _meta?: ServerMeta;
+}
+/** Registry extensions metadata */
+export interface RegistryExtensions {
+    /** Server lifecycle status */
+    status: ServerStatus;
+    /** Timestamp when the server was first published */
+    publishedAt: string;
+    /** Whether this is the latest version of the server */
+    isLatest: boolean;
+    /** Timestamp when the server entry was last updated */
+    updatedAt?: string;
+}
+/** Response metadata */
+export interface ResponseMeta {
+    'io.modelcontextprotocol.registry/official'?: RegistryExtensions;
+}
+/** Server response (server + metadata) */
+export interface ServerResponse {
+    /** Server configuration and metadata */
+    server: ServerJSON;
+    /** Registry-managed metadata */
+    _meta: ResponseMeta;
+}
+/** Pagination metadata */
+export interface PaginationMetadata {
+    /** Number of items in current page */
+    count: number;
+    /** Pagination cursor for retrieving the next page */
+    nextCursor?: string;
+}
+/** Server list response */
+export interface ServerListResponse {
+    /** List of server entries */
+    servers: ServerResponse[] | null;
+    /** Pagination metadata */
+    metadata: PaginationMetadata;
+}
+/** API error detail */
+export interface ErrorDetail {
+    /** Where the error occurred */
+    location?: string;
+    /** Error message text */
+    message?: string;
+    /** The value at the given location */
+    value?: unknown;
+}
+/** API error response */
+export interface ErrorResponse {
+    /** HTTP status code */
+    status?: number;
+    /** A short, human-readable summary of the problem type */
+    title?: string;
+    /** A human-readable explanation specific to this occurrence */
+    detail?: string;
+    /** A URI reference to human-readable documentation for the error */
+    type?: string;
+    /** A URI reference that identifies the specific occurrence */
+    instance?: string;
+    /** Optional list of individual error details */
+    errors?: ErrorDetail[] | null;
+}
+/** Options for listing servers */
+export interface ListServersOptions {
+    /** Pagination cursor */
+    cursor?: string;
+    /** Number of items per page (1-100, default 30) */
+    limit?: number;
+    /** Filter servers updated since timestamp (RFC3339 datetime) */
+    updatedSince?: string;
+    /** Search servers by name (substring match) */
+    search?: string;
+    /** Filter by version ('latest' for latest version, or an exact version) */
+    version?: string;
+}
+/** Options for getting a specific server version */
+export interface GetServerOptions {
+    /** Server version (use 'latest' for the latest version) */
+    version?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * Types for the official MCP Registry API.
+ * Based on the OpenAPI spec at https://registry.modelcontextprotocol.io/openapi.yaml
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/package.json

@@ -0,0 +1,41 @@
+{
+   "name": "@a1st/mcp-registry-client",
+   "version": "0.0.3",
+   "description": "TypeScript client for the official MCP Registry API",
+   "keywords": [
+      "api-client",
+      "mcp",
+      "model-context-protocol",
+      "registry"
+   ],
+   "license": "MIT",
+   "repository": {
+      "type": "git",
+      "url": "https://github.com/a1st-dev/aix.git",
+      "directory": "packages/mcp-registry-client"
+   },
+   "files": [
+      "dist"
+   ],
+   "type": "module",
+   "main": "./dist/index.js",
+   "types": "./dist/index.d.ts",
+   "exports": {
+      ".": {
+         "types": "./dist/index.d.ts",
+         "import": "./dist/index.js"
+      }
+   },
+   "publishConfig": {
+      "access": "public",
+      "registry": "https://registry.npmjs.org/"
+   },
+   "scripts": {
+      "build": "tsc -p tsconfig.build.json",
+      "test": "vitest run --passWithNoTests",
+      "test:watch": "vitest"
+   },
+   "dependencies": {
+      "p-map": "7.0.4"
+   }
+}