@dexto/registry 1.4.0

package/dist/mcp/server-registry.d.ts

@@ -0,0 +1,61 @@
+/**
+ * MCP Server Registry Service
+ *
+ * Provides access to the built-in registry of MCP servers.
+ * This is a shared service used by both CLI and WebUI.
+ */
+import type { ServerRegistryEntry, ServerRegistryFilter } from './types.js';
+/**
+ * MCP Server Registry Service
+ *
+ * Manages a registry of available MCP servers that can be quickly added to agents.
+ * The built-in registry data is loaded from an external JSON file.
+ */
+export declare class ServerRegistryService {
+    private static instance;
+    private registryEntries;
+    private isInitialized;
+    private constructor();
+    static getInstance(): ServerRegistryService;
+    /**
+     * Initialize the registry with default entries
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get all registry entries with optional filtering
+     */
+    getEntries(filter?: ServerRegistryFilter): Promise<ServerRegistryEntry[]>;
+    /**
+     * Update an existing registry entry's state
+     */
+    updateEntry(id: string, updates: Partial<ServerRegistryEntry>): Promise<boolean>;
+    /**
+     * Mark a server as installed/uninstalled
+     */
+    setInstalled(id: string, installed: boolean): Promise<boolean>;
+    /**
+     * Sync registry installed status with a list of connected server IDs
+     */
+    syncInstalledStatus(connectedServerIds: string[]): Promise<void>;
+    /**
+     * Get a single server configuration by ID
+     */
+    getServerConfig(id: string): Promise<ServerRegistryEntry | null>;
+    /**
+     * Get all available categories
+     */
+    getCategories(): Promise<string[]>;
+    /**
+     * Get all available tags
+     */
+    getTags(): Promise<string[]>;
+}
+/**
+ * Get the singleton registry instance
+ */
+export declare function getServerRegistry(): ServerRegistryService;
+/**
+ * Export singleton instance for convenience
+ */
+export declare const serverRegistry: ServerRegistryService;
+//# sourceMappingURL=server-registry.d.ts.map

package/dist/mcp/server-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-registry.d.ts","sourceRoot":"","sources":["../../src/mcp/server-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAa5E;;;;;GAKG;AACH,qBAAa,qBAAqB;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAwB;IAC/C,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,aAAa,CAAS;IAE9B,OAAO;IAIP,MAAM,CAAC,WAAW,IAAI,qBAAqB;IAO3C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC;;OAEG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IA6C/E;;OAEG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAWtF;;OAEG;IACG,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpE;;OAEG;IACG,mBAAmB,CAAC,kBAAkB,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBtE;;OAEG;IACG,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAKtE;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAMxC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAKrC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,qBAAqB,CAEzD;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,uBAAsC,CAAC"}

package/dist/mcp/types.d.ts

@@ -0,0 +1,83 @@
+/**
+ * MCP Server Registry Types
+ *
+ * Defines types for the MCP server registry, which provides
+ * preset server configurations for easy installation.
+ */
+/**
+ * Server category for organization and filtering
+ */
+export type ServerCategory = 'productivity' | 'development' | 'research' | 'creative' | 'data' | 'communication' | 'custom';
+/**
+ * Server configuration for different transport types
+ */
+export interface ServerConfig {
+    type: 'stdio' | 'sse' | 'http';
+    command?: string;
+    args?: string[];
+    url?: string;
+    baseUrl?: string;
+    env?: Record<string, string>;
+    headers?: Record<string, string>;
+    timeout?: number;
+}
+/**
+ * Platform and dependency requirements for a server
+ */
+export interface ServerRequirements {
+    platform?: 'win32' | 'darwin' | 'linux' | 'all';
+    node?: string;
+    python?: string;
+    dependencies?: string[];
+}
+/**
+ * A single entry in the MCP server registry
+ */
+export interface ServerRegistryEntry {
+    /** Unique identifier for the server */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Description of what the server does */
+    description: string;
+    /** Category for organization */
+    category: ServerCategory;
+    /** Emoji icon for display */
+    icon?: string;
+    /** Author or maintainer */
+    author?: string;
+    /** Homepage or documentation URL */
+    homepage?: string;
+    /** Server connection configuration */
+    config: ServerConfig;
+    /** Tags for search and filtering */
+    tags: string[];
+    /** Whether this is an official/verified server */
+    isOfficial: boolean;
+    /** Whether this server is currently installed (runtime state) */
+    isInstalled: boolean;
+    /** System requirements */
+    requirements?: ServerRequirements;
+    /** Alternative IDs used to match against connected servers */
+    matchIds?: string[];
+}
+/**
+ * Filter options for querying the registry
+ */
+export interface ServerRegistryFilter {
+    category?: string;
+    tags?: string[];
+    search?: string;
+    installed?: boolean;
+    official?: boolean;
+}
+/**
+ * State container for registry UI
+ */
+export interface ServerRegistryState {
+    entries: ServerRegistryEntry[];
+    isLoading: boolean;
+    error?: string;
+    lastUpdated?: Date;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/mcp/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,cAAc,GACpB,cAAc,GACd,aAAa,GACb,UAAU,GACV,UAAU,GACV,MAAM,GACN,eAAe,GACf,QAAQ,CAAC;AAEf;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAC;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,QAAQ,EAAE,cAAc,CAAC;IACzB,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,MAAM,EAAE,YAAY,CAAC;IACrB,oCAAoC;IACpC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,kDAAkD;IAClD,UAAU,EAAE,OAAO,CAAC;IACpB,iEAAiE;IACjE,WAAW,EAAE,OAAO,CAAC;IACrB,0BAA0B;IAC1B,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,IAAI,CAAC;CACtB"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@dexto/registry",
+  "version": "1.4.0",
+  "private": false,
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5"
+  },
+  "scripts": {
+    "build": "tsup && tsc -p tsconfig.json --emitDeclarationOnly",
+    "dev": "tsup --watch",
+    "typecheck": "tsc -p tsconfig.typecheck.json --noEmit",
+    "lint": "eslint . --ext .ts"
+  }
+}