@uidbai/mcp-server 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 UIDB
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,133 @@
+# @uidbai/mcp-server
+
+Model Context Protocol (MCP) server for the UIDB Design System. Enables AI coding assistants (Cursor, Claude, etc.) to build consistent, accessible UI components.
+
+## Installation
+
+No installation required! Use directly with `npx`:
+
+```bash
+npx @uidbai/mcp-server
+```
+
+## Quick Start
+
+### 1. Add to Cursor
+
+Create `.cursor/mcp.json` in your project:
+
+```json
+{
+  "mcpServers": {
+    "uidb": {
+      "command": "npx",
+      "args": ["-y", "@uidb/mcp-server"]
+    }
+  }
+}
+```
+
+### 2. Authenticate
+
+Get your token from [portal.uidb.ai](https://portal.uidb.ai) → Your Project → Connect, then run:
+
+```bash
+npx @uidbai/mcp-server login --token=YOUR_TOKEN
+```
+
+### 3. Restart Cursor
+
+Restart your AI coding tool to load the UIDB MCP server.
+
+## Available Tools
+
+| Tool                   | Description                   |
+| ---------------------- | ----------------------------- |
+| `uidb_ask_intent`      | Start component guidance flow |
+| `uidb_ask_question`    | Continue guidance Q&A         |
+| `uidb_finalize`        | Get final component code      |
+| `uidb_list_components` | List available components     |
+| `uidb_detect_pattern`  | Check if code is a pattern    |
+| `uidb_submit_pattern`  | Submit a new pattern          |
+| `uidb_list_patterns`   | List project patterns         |
+| `uidb_get_config`      | Get theme configuration       |
+| `uidb_update_config`   | Update theme settings         |
+| `uidb_login`           | Authenticate with UIDB        |
+| `uidb_status`          | Check connection status       |
+
+## CLI Commands
+
+```bash
+# Start MCP server (default)
+npx @uidbai/mcp-server
+
+# Authenticate
+npx @uidbai/mcp-server login --token=YOUR_TOKEN
+
+# Check status
+npx @uidbai/mcp-server status
+
+# Logout
+npx @uidbai/mcp-server logout
+```
+
+## Configuration for Other Tools
+
+### Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "uidb": {
+      "command": "npx",
+      "args": ["-y", "@uidb/mcp-server"]
+    }
+  }
+}
+```
+
+### Windsurf / Other MCP Tools
+
+Follow your tool's MCP configuration guide, using:
+
+- Command: `npx`
+- Args: `["-y", "@uidb/mcp-server"]`
+
+## How It Works
+
+1. **Component Guidance**: When you need a UI component, ask your AI assistant. It will use `uidb_ask_intent` to start a guidance flow, walking you through selecting the right component, variant, size, and colors.
+
+2. **Pattern Detection**: After building multi-component UIs, the assistant can use `uidb_detect_pattern` to check if it's a reusable pattern worth documenting.
+
+3. **Theme Consistency**: The assistant uses `uidb_get_config` to ensure all components match your project's theme (accent color, gray scale, border radius).
+
+## Resources
+
+The MCP server exposes these resources:
+
+- `uidb://project/{slug}/config` - Design system configuration
+- `uidb://project/{slug}/components` - Available components
+- `uidb://project/{slug}/patterns` - Documented patterns
+
+## Prompts
+
+Built-in prompts for common workflows:
+
+- `uidb_component_guidance` - System prompt for component selection
+- `uidb_pattern_detection` - System prompt for pattern detection
+
+## Credential Storage
+
+Credentials are stored securely in `~/.uidb/credentials.json` with restricted file permissions. No credentials are stored in your project files.
+
+## Support
+
+- **Portal**: [portal.uidb.ai](https://portal.uidb.ai)
+- **Documentation**: [docs.uidb.ai](https://docs.uidb.ai)
+- **Issues**: [github.com/uidb/mcp-server/issues](https://github.com/uidb/mcp-server/issues)
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * UIDB MCP Server CLI
+ *
+ * Command-line interface for authentication and management.
+ *
+ * Usage:
+ *   npx @uidbai/mcp-server login --token=YOUR_TOKEN
+ *   npx @uidbai/mcp-server status
+ *   npx @uidbai/mcp-server logout
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG"}

package/dist/cli.js

@@ -0,0 +1,117 @@
+#!/usr/bin/env node
+/**
+ * UIDB MCP Server CLI
+ *
+ * Command-line interface for authentication and management.
+ *
+ * Usage:
+ *   npx @uidbai/mcp-server login --token=YOUR_TOKEN
+ *   npx @uidbai/mcp-server status
+ *   npx @uidbai/mcp-server logout
+ */
+import { Command } from "commander";
+import { exchangeToken, getAuthStatus, deleteCredentials, isAuthenticated, } from "./core/auth.js";
+const program = new Command();
+program
+    .name("uidb-mcp")
+    .description("UIDB Design System MCP Server CLI")
+    .version("0.1.0");
+// ============================================================================
+// Login Command
+// ============================================================================
+program
+    .command("login")
+    .description("Authenticate with UIDB using a one-time token from the portal")
+    .option("-t, --token <token>", "One-time authentication token from UIDB portal")
+    .action(async (options) => {
+    if (!options.token) {
+        // Check if already authenticated
+        const authenticated = await isAuthenticated();
+        if (authenticated) {
+            const status = await getAuthStatus();
+            console.log("\n✓ Already authenticated");
+            console.log(`  Project: ${status.projectSlug}`);
+            console.log(`  User: ${status.userEmail}`);
+            console.log(`  Expires: ${status.expiresAt}`);
+            console.log("\nTo switch projects, get a new token from portal.uidb.ai");
+            return;
+        }
+        console.log("\n⚠ No token provided\n");
+        console.log("To authenticate with UIDB:");
+        console.log("  1. Go to portal.uidb.ai");
+        console.log("  2. Select your project → Connect");
+        console.log("  3. Copy the login command with token");
+        console.log("  4. Run: npx @uidbai/mcp-server login --token=YOUR_TOKEN\n");
+        process.exit(1);
+    }
+    try {
+        console.log("\n⏳ Authenticating...");
+        const credentials = await exchangeToken(options.token);
+        console.log("\n✓ Successfully authenticated!");
+        console.log(`  Project: ${credentials.projectSlug}`);
+        console.log(`  User: ${credentials.userEmail}`);
+        console.log(`  Expires: ${credentials.expiresAt}`);
+        console.log("\nUIDB MCP server is now ready to use.");
+        console.log("Restart your AI coding tool to load the new credentials.\n");
+    }
+    catch (error) {
+        console.error("\n✗ Authentication failed");
+        console.error(`  ${error instanceof Error ? error.message : "Unknown error"}`);
+        console.error("\nMake sure your token is valid and hasn't expired.");
+        console.error("Get a new token from portal.uidb.ai → Your Project → Connect\n");
+        process.exit(1);
+    }
+});
+// ============================================================================
+// Status Command
+// ============================================================================
+program
+    .command("status")
+    .description("Check UIDB connection status")
+    .action(async () => {
+    const status = await getAuthStatus();
+    if (!status.authenticated) {
+        console.log("\n✗ Not connected to UIDB");
+        console.log("\nTo connect:");
+        console.log("  1. Go to portal.uidb.ai");
+        console.log("  2. Select your project → Connect");
+        console.log("  3. Run the login command\n");
+        process.exit(1);
+    }
+    console.log("\n✓ Connected to UIDB");
+    console.log(`  Project: ${status.projectSlug}`);
+    console.log(`  User: ${status.userEmail}`);
+    console.log(`  Expires: ${status.expiresAt}\n`);
+});
+// ============================================================================
+// Logout Command
+// ============================================================================
+program
+    .command("logout")
+    .description("Remove UIDB credentials")
+    .action(async () => {
+    try {
+        await deleteCredentials();
+        console.log("\n✓ Logged out successfully");
+        console.log("  Credentials have been removed.\n");
+    }
+    catch (error) {
+        console.error("\n✗ Logout failed");
+        console.error(`  ${error instanceof Error ? error.message : "Unknown error"}\n`);
+        process.exit(1);
+    }
+});
+// ============================================================================
+// Default: Run MCP Server
+// ============================================================================
+program
+    .command("serve", { isDefault: true })
+    .description("Start the MCP server (default command)")
+    .action(async () => {
+    // Import and run server
+    const { runServer } = await import("./server.js");
+    await runServer();
+});
+// Parse and execute
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/core/api-client.d.ts

@@ -0,0 +1,45 @@
+/**
+ * UIDB MCP Server - API Client
+ *
+ * HTTP client for communicating with the UIDB REST API.
+ * Handles authentication headers and error responses.
+ */
+import { UIDBCredentials } from "./types.js";
+export interface RequestOptions {
+    method?: "GET" | "POST" | "PUT" | "DELETE";
+    body?: unknown;
+    headers?: Record<string, string>;
+}
+/**
+ * Make an authenticated request to the UIDB API
+ */
+export declare function apiRequest<T>(endpoint: string, options?: RequestOptions): Promise<T>;
+/**
+ * Make a request with explicit credentials
+ */
+export declare function apiRequestWithCredentials<T>(endpoint: string, credentials: UIDBCredentials, options?: RequestOptions): Promise<T>;
+/**
+ * GET request
+ */
+export declare function get<T>(endpoint: string): Promise<T>;
+/**
+ * POST request
+ */
+export declare function post<T>(endpoint: string, body: unknown): Promise<T>;
+/**
+ * PUT request
+ */
+export declare function put<T>(endpoint: string, body: unknown): Promise<T>;
+/**
+ * DELETE request
+ */
+export declare function del<T>(endpoint: string): Promise<T>;
+export declare const apiClient: {
+    get: typeof get;
+    post: typeof post;
+    put: typeof put;
+    delete: typeof del;
+    request: typeof apiRequest;
+};
+export default apiClient;
+//# sourceMappingURL=api-client.d.ts.map

package/dist/core/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../src/core/api-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAgB,eAAe,EAAE,MAAM,YAAY,CAAC;AAQ3D,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC3C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,CAAC,CAAC,CAIZ;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAAC,CAAC,EAC/C,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,eAAe,EAC5B,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,CAAC,CAAC,CAqDZ;AAMD;;GAEG;AACH,wBAAsB,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAEzD;AAED;;GAEG;AACH,wBAAsB,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAEzE;AAED;;GAEG;AACH,wBAAsB,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAExE;AAED;;GAEG;AACH,wBAAsB,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAEzD;AAMD,eAAO,MAAM,SAAS;;;;;;CAMrB,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/dist/core/api-client.js

@@ -0,0 +1,98 @@
+/**
+ * UIDB MCP Server - API Client
+ *
+ * HTTP client for communicating with the UIDB REST API.
+ * Handles authentication headers and error responses.
+ */
+import { UIDB_API_URL } from "./types.js";
+import { requireCredentials } from "./auth.js";
+import { APIError, NetworkError, AuthenticationError } from "./errors.js";
+/**
+ * Make an authenticated request to the UIDB API
+ */
+export async function apiRequest(endpoint, options = {}) {
+    const credentials = await requireCredentials();
+    return apiRequestWithCredentials(endpoint, credentials, options);
+}
+/**
+ * Make a request with explicit credentials
+ */
+export async function apiRequestWithCredentials(endpoint, credentials, options = {}) {
+    const { method = "GET", body, headers = {} } = options;
+    const url = `${UIDB_API_URL}${endpoint}`;
+    try {
+        const fetchOptions = {
+            method,
+            headers: {
+                "Content-Type": "application/json",
+                "X-UIDB-API-Key": credentials.accessToken,
+                "X-UIDB-Project-ID": credentials.projectId,
+                ...headers,
+            },
+        };
+        if (body) {
+            fetchOptions.body = JSON.stringify(body);
+        }
+        const response = await fetch(url, fetchOptions);
+        // Handle authentication errors
+        if (response.status === 401) {
+            throw new AuthenticationError("Session expired. Run 'npx @uidbai/mcp-server login' to reconnect.");
+        }
+        // Handle other errors
+        if (!response.ok) {
+            const errorData = await response.json().catch(() => ({}));
+            throw new APIError(errorData.message ||
+                errorData.error ||
+                `API request failed: ${response.status}`, response.status);
+        }
+        // Parse response
+        const data = await response.json();
+        return data;
+    }
+    catch (error) {
+        if (error instanceof APIError || error instanceof AuthenticationError) {
+            throw error;
+        }
+        // Network or other errors
+        throw new NetworkError(`Failed to reach UIDB API: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+}
+// ============================================================================
+// Convenience Methods
+// ============================================================================
+/**
+ * GET request
+ */
+export async function get(endpoint) {
+    return apiRequest(endpoint, { method: "GET" });
+}
+/**
+ * POST request
+ */
+export async function post(endpoint, body) {
+    return apiRequest(endpoint, { method: "POST", body });
+}
+/**
+ * PUT request
+ */
+export async function put(endpoint, body) {
+    return apiRequest(endpoint, { method: "PUT", body });
+}
+/**
+ * DELETE request
+ */
+export async function del(endpoint) {
+    return apiRequest(endpoint, { method: "DELETE" });
+}
+// ============================================================================
+// API Client Instance
+// ============================================================================
+export const apiClient = {
+    get,
+    post,
+    put,
+    delete: del,
+    request: apiRequest,
+};
+export default apiClient;
+//# sourceMappingURL=api-client.js.map

package/dist/core/api-client.js.map

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

package/dist/core/auth.d.ts

@@ -0,0 +1,42 @@
+/**
+ * UIDB MCP Server - Authentication
+ *
+ * Handles OAuth authentication and credential storage.
+ * Credentials are stored in ~/.uidb/credentials.json
+ */
+import { UIDBCredentials } from "./types.js";
+/**
+ * Load credentials from disk
+ */
+export declare function loadCredentials(): Promise<UIDBCredentials | null>;
+/**
+ * Save credentials to disk
+ */
+export declare function saveCredentials(credentials: UIDBCredentials): Promise<void>;
+/**
+ * Delete credentials from disk
+ */
+export declare function deleteCredentials(): Promise<void>;
+/**
+ * Exchange one-time token for access credentials
+ * Called by CLI: npx @uidbai/mcp-server login --token=xxx
+ */
+export declare function exchangeToken(oneTimeToken: string): Promise<UIDBCredentials>;
+/**
+ * Get current credentials or throw if not authenticated
+ */
+export declare function requireCredentials(): Promise<UIDBCredentials>;
+/**
+ * Check if user is authenticated
+ */
+export declare function isAuthenticated(): Promise<boolean>;
+/**
+ * Get authentication status info
+ */
+export declare function getAuthStatus(): Promise<{
+    authenticated: boolean;
+    projectSlug?: string;
+    userEmail?: string;
+    expiresAt?: string;
+}>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/core/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/core/auth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EACL,eAAe,EAGhB,MAAM,YAAY,CAAC;AAoBpB;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CA4BvE;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,eAAe,GAC3B,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAOvD;AAMD;;;GAGG;AACH,wBAAsB,aAAa,CACjC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,eAAe,CAAC,CAuC1B;AAmDD;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC,CAQnE;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAOxD;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC;IAC7C,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC,CAiBD"}