@myvtp/mcp 0.1.0 → 0.2.0

package/README.md

@@ -2,9 +2,36 @@
 
 MCP (Model Context Protocol) server for VTP - deploy apps via Claude Code.
 
-## Installation
+## Quick Start
 
-Add to your Claude Code configuration (`~/.claude.json`):
+Run the installer to automatically configure your AI coding assistant:
+
+```bash
+npx myvtp-mcp install
+```
+
+This will detect and configure any of the following clients:
+- **Claude Desktop** - Anthropic's desktop app
+- **Claude Code** - Anthropic's CLI tool
+- **Cursor** - AI-powered code editor
+- **VS Code** - Project-level MCP config
+- **Windsurf** - Codeium's AI code editor
+- **Project (.mcp.json)** - Generic project-level config
+
+### Installer Options
+
+```bash
+npx myvtp-mcp install              # Interactive mode
+npx myvtp-mcp install --yes        # Configure all detected clients
+npx myvtp-mcp install --yes claude-desktop  # Configure specific client
+npx myvtp-mcp install --force      # Overwrite existing VTP config
+```
+
+Press **Escape** or **Ctrl+C** to cancel the installer.
+
+## Manual Installation
+
+Add to your MCP configuration file:
 
 ```json
 {
@@ -17,9 +44,21 @@ Add to your Claude Code configuration (`~/.claude.json`):
 }
 ```
 
+### Config File Locations
+
+| Client | Config Path |
+|--------|-------------|
+| Claude Desktop (macOS) | `~/Library/Application Support/Claude/claude_desktop_config.json` |
+| Claude Desktop (Windows) | `%APPDATA%\Claude\claude_desktop_config.json` |
+| Claude Code | `~/.claude.json` |
+| Cursor | `~/.cursor/mcp.json` |
+| VS Code | `.vscode/mcp.json` (project-level) |
+| Windsurf | `~/.codeium/windsurf/mcp_config.json` |
+| Generic | `.mcp.json` (project-level) |
+
 ## Usage
 
-Once configured, simply ask Claude Code to deploy your app:
+Once configured, simply ask Claude to deploy your app:
 
 ```
 Deploy this app to VTP

package/dist/index.d.ts

@@ -1,3 +1,10 @@
 #!/usr/bin/env node
+/**
+ * VTP MCP Package Entry Point
+ *
+ * Routes to either the MCP server or the install command based on arguments:
+ * - `npx myvtp-mcp` or `npx -y @myvtp/mcp` → runs the MCP server
+ * - `npx myvtp-mcp install` → runs the installer
+ */
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1,172 +1,19 @@
 #!/usr/bin/env node
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
-import { existsSync } from 'fs';
-import * as client from './client.js';
-import { DeploySchema, GuideTypeSchema, toolDefinitions } from './tools.js';
-const server = new Server({
-    name: 'vtp',
-    version: '0.7.0',
-}, {
-    capabilities: {
-        tools: {},
-    },
-});
-// List available tools
-server.setRequestHandler(ListToolsRequestSchema, async () => ({
-    tools: toolDefinitions,
-}));
-// Handle tool calls - all delegate to HTTP API via client
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-    const { name, arguments: args } = request.params;
-    try {
-        switch (name) {
-            case 'list_app_types': {
-                const types = await client.listAppTypes();
-                const typeList = types
-                    .map(t => `- **${t.displayName}** (${t.type})\n  ${t.description}`)
-                    .join('\n');
-                return {
-                    content: [{
-                            type: 'text',
-                            text: `Supported app types:\n\n${typeList}\n\n` +
-                                `Use get_deployment_guide with a type to see detailed instructions.`,
-                        }],
-                };
-            }
-            case 'get_deployment_guide': {
-                const { type: guideType } = GuideTypeSchema.parse(args);
-                try {
-                    const guide = await client.getDeploymentGuide(guideType);
-                    return {
-                        content: [{
-                                type: 'text',
-                                text: guide.content,
-                            }],
-                    };
-                }
-                catch (error) {
-                    if (error instanceof Error && error.message.includes('guide_not_found')) {
-                        const types = await client.listAppTypes();
-                        const available = types.map(t => t.type).join(', ');
-                        return {
-                            content: [{
-                                    type: 'text',
-                                    text: `Unknown app type: "${guideType}"\n\nAvailable types: ${available}`,
-                                }],
-                            isError: true,
-                        };
-                    }
-                    throw error;
-                }
-            }
-            case 'deploy': {
-                const { config, force } = DeploySchema.parse(args);
-                const configPath = config || './vtp.yaml';
-                // Validate config exists
-                if (!existsSync(configPath)) {
-                    return {
-                        content: [{
-                                type: 'text',
-                                text: `Error: Config file not found: ${configPath}\n\n` +
-                                    `Create a vtp.yaml file with:\n` +
-                                    `  name: My App Name      # Display name\n` +
-                                    `  id: my-app             # Optional: URL slug\n` +
-                                    `  type: static           # or "node"\n` +
-                                    `  path: ./dist           # folder to deploy\n\n` +
-                                    `Use list_app_types and get_deployment_guide for help.`,
-                            }],
-                        isError: true,
-                    };
-                }
-                // Deploy via HTTP API
-                const result = await client.deploy(configPath, force ?? false);
-                // Handle conflict
-                if (result.error === 'conflict') {
-                    const existingApp = result.existingApp;
-                    return {
-                        content: [{
-                                type: 'text',
-                                text: `App '${existingApp?.id}' already exists at ${existingApp?.url || 'unknown URL'}\n` +
-                                    `Name: ${existingApp?.name || 'unknown'}\n` +
-                                    `Status: ${existingApp?.status || 'unknown'}\n\n` +
-                                    `Use force: true to replace it.`,
-                            }],
-                    };
-                }
-                // Handle other errors
-                if (result.error) {
-                    return {
-                        content: [{
-                                type: 'text',
-                                text: `Error: ${result.message || result.error}`,
-                            }],
-                        isError: true,
-                    };
-                }
-                // Success
-                const app = result.app;
-                const prefix = result.replaced ? 'Replaced' : 'Deployed';
-                return {
-                    content: [{
-                            type: 'text',
-                            text: `${prefix} ${app.name} (@${app.id})\n` +
-                                `  URL: ${app.url}\n` +
-                                `  Type: ${app.type}\n` +
-                                `  Status: ${app.status}`,
-                        }],
-                };
-            }
-            case 'list': {
-                const apps = await client.listApps();
-                if (apps.length === 0) {
-                    return {
-                        content: [{
-                                type: 'text',
-                                text: 'No apps deployed yet.',
-                            }],
-                    };
-                }
-                const appList = apps
-                    .map(app => {
-                    const desc = app.description ? `\n  ${app.description}` : '';
-                    return `- ${app.name} (@${app.id}) - ${app.type} - ${app.status}${desc}\n  ${app.url}`;
-                })
-                    .join('\n');
-                return {
-                    content: [{
-                            type: 'text',
-                            text: `Deployed apps:\n${appList}`,
-                        }],
-                };
-            }
-            default:
-                return {
-                    content: [{
-                            type: 'text',
-                            text: `Unknown tool: ${name}`,
-                        }],
-                    isError: true,
-                };
-        }
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        return {
-            content: [{
-                    type: 'text',
-                    text: `Error: ${message}`,
-                }],
-            isError: true,
-        };
-    }
-});
-// Start the server
-async function main() {
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-    console.error('VTP MCP server running on stdio');
+/**
+ * VTP MCP Package Entry Point
+ *
+ * Routes to either the MCP server or the install command based on arguments:
+ * - `npx myvtp-mcp` or `npx -y @myvtp/mcp` → runs the MCP server
+ * - `npx myvtp-mcp install` → runs the installer
+ */
+const args = process.argv.slice(2);
+if (args[0] === 'install') {
+    // Run the install command
+    import('./install/index.js').then(m => m.default(args.slice(1)));
 }
-main().catch(console.error);
+else {
+    // Run the MCP server (default)
+    import('./server.js');
+}
+export {};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;GAMG;AAEH,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEnC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;IAC1B,0BAA0B;IAC1B,MAAM,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACnE,CAAC;KAAM,CAAC;IACN,+BAA+B;IAC/B,MAAM,CAAC,aAAa,CAAC,CAAC;AACxB,CAAC"}

package/dist/install/clients.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Client detection utilities
+ */
+import type { ClientConfig, DetectedClient } from './types.js';
+/**
+ * Get the config path for a client on the current platform
+ */
+export declare function getConfigPath(client: ClientConfig): string | null;
+/**
+ * Detect a single client's status
+ */
+export declare function detectClient(client: ClientConfig): DetectedClient | null;
+/**
+ * Detect all available clients on the current system
+ */
+export declare function detectAllClients(): DetectedClient[];
+/**
+ * Filter clients by ID
+ */
+export declare function filterClients(clients: DetectedClient[], ids: string[]): DetectedClient[];
+/**
+ * Get a client by ID
+ */
+export declare function getClientById(id: string): ClientConfig | undefined;
+//# sourceMappingURL=clients.d.ts.map

package/dist/install/clients.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients.d.ts","sourceRoot":"","sources":["../../src/install/clients.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE/D;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI,CAGjE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,cAAc,GAAG,IAAI,CA4BxE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,cAAc,EAAE,CAWnD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE,CAExF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAElE"}

package/dist/install/clients.js

@@ -0,0 +1,68 @@
+/**
+ * Client detection utilities
+ */
+import { existsSync } from 'fs';
+import { CLIENTS, VTP_SERVER_NAME } from './constants.js';
+import { isVtpConfigured, readConfig } from './config.js';
+/**
+ * Get the config path for a client on the current platform
+ */
+export function getConfigPath(client) {
+    const platform = process.platform;
+    return client.paths[platform] || null;
+}
+/**
+ * Detect a single client's status
+ */
+export function detectClient(client) {
+    const configPath = getConfigPath(client);
+    if (!configPath) {
+        return null;
+    }
+    const configExists = existsSync(configPath);
+    let existingConfig = null;
+    let vtpConfigured = false;
+    if (configExists) {
+        try {
+            existingConfig = readConfig(configPath);
+            vtpConfigured = isVtpConfigured(existingConfig, VTP_SERVER_NAME);
+        }
+        catch {
+            // Config exists but is invalid - we can still offer to fix it
+            existingConfig = null;
+        }
+    }
+    return {
+        client,
+        configPath,
+        configExists,
+        vtpConfigured,
+        existingConfig: existingConfig || undefined,
+    };
+}
+/**
+ * Detect all available clients on the current system
+ */
+export function detectAllClients() {
+    const detected = [];
+    for (const client of CLIENTS) {
+        const result = detectClient(client);
+        if (result) {
+            detected.push(result);
+        }
+    }
+    return detected;
+}
+/**
+ * Filter clients by ID
+ */
+export function filterClients(clients, ids) {
+    return clients.filter(c => ids.includes(c.client.id));
+}
+/**
+ * Get a client by ID
+ */
+export function getClientById(id) {
+    return CLIENTS.find(c => c.id === id);
+}
+//# sourceMappingURL=clients.js.map

package/dist/install/clients.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients.js","sourceRoot":"","sources":["../../src/install/clients.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG1D;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAAoB;IAChD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAwC,CAAC;IAClE,OAAO,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAEzC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,YAAY,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IAC5C,IAAI,cAAc,GAAG,IAAI,CAAC;IAC1B,IAAI,aAAa,GAAG,KAAK,CAAC;IAE1B,IAAI,YAAY,EAAE,CAAC;QACjB,IAAI,CAAC;YACH,cAAc,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;YACxC,aAAa,GAAG,eAAe,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;QACnE,CAAC;QAAC,MAAM,CAAC;YACP,8DAA8D;YAC9D,cAAc,GAAG,IAAI,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO;QACL,MAAM;QACN,UAAU;QACV,YAAY;QACZ,aAAa;QACb,cAAc,EAAE,cAAc,IAAI,SAAS;KAC5C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,QAAQ,GAAqB,EAAE,CAAC;IAEtC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,MAAM,EAAE,CAAC;YACX,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAAyB,EAAE,GAAa;IACpE,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,EAAU;IACtC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AACxC,CAAC"}

package/dist/install/config.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Configuration file reading and writing utilities
+ */
+import type { McpConfig, McpServerConfig } from './types.js';
+/**
+ * Read and parse a JSON config file
+ * Returns null if file doesn't exist, throws on parse error
+ */
+export declare function readConfig(configPath: string): McpConfig | null;
+/**
+ * Check if VTP is already configured in a config file
+ */
+export declare function isVtpConfigured(config: McpConfig | null, serverName: string): boolean;
+/**
+ * Merge VTP server config into existing config
+ * Creates a new config if none exists
+ * Preserves all existing servers and settings
+ */
+export declare function mergeVtpConfig(existingConfig: McpConfig | null, serverName: string, serverConfig: McpServerConfig, force?: boolean): {
+    config: McpConfig;
+    action: 'created' | 'updated' | 'skipped';
+};
+/**
+ * Write config to file, creating directories as needed
+ */
+export declare function writeConfig(configPath: string, config: McpConfig): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/install/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/install/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7D;;;GAGG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAc/D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAKrF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,cAAc,EAAE,SAAS,GAAG,IAAI,EAChC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,eAAe,EAC7B,KAAK,GAAE,OAAe,GACrB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAA;CAAE,CAuBlE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAUvE"}

package/dist/install/config.js

@@ -0,0 +1,70 @@
+/**
+ * Configuration file reading and writing utilities
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { dirname } from 'path';
+/**
+ * Read and parse a JSON config file
+ * Returns null if file doesn't exist, throws on parse error
+ */
+export function readConfig(configPath) {
+    if (!existsSync(configPath)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(configPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            throw new Error(`Invalid JSON in ${configPath}: ${error.message}`);
+        }
+        throw error;
+    }
+}
+/**
+ * Check if VTP is already configured in a config file
+ */
+export function isVtpConfigured(config, serverName) {
+    if (!config?.mcpServers) {
+        return false;
+    }
+    return serverName in config.mcpServers;
+}
+/**
+ * Merge VTP server config into existing config
+ * Creates a new config if none exists
+ * Preserves all existing servers and settings
+ */
+export function mergeVtpConfig(existingConfig, serverName, serverConfig, force = false) {
+    const config = existingConfig ? { ...existingConfig } : {};
+    // Ensure mcpServers exists
+    if (!config.mcpServers) {
+        config.mcpServers = {};
+    }
+    // Check if already configured
+    const alreadyConfigured = serverName in config.mcpServers;
+    if (alreadyConfigured && !force) {
+        return { config, action: 'skipped' };
+    }
+    // Add or update VTP server
+    config.mcpServers = {
+        ...config.mcpServers,
+        [serverName]: serverConfig,
+    };
+    const action = existingConfig === null ? 'created' : 'updated';
+    return { config, action };
+}
+/**
+ * Write config to file, creating directories as needed
+ */
+export function writeConfig(configPath, config) {
+    const dir = dirname(configPath);
+    // Create directory if it doesn't exist
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    const content = JSON.stringify(config, null, 2);
+    writeFileSync(configPath, content + '\n', 'utf-8');
+}
+//# sourceMappingURL=config.js.map

package/dist/install/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/install/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAG/B;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,UAAkB;IAC3C,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAc,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,mBAAmB,UAAU,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACrE,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAwB,EAAE,UAAkB;IAC1E,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,cAAgC,EAChC,UAAkB,EAClB,YAA6B,EAC7B,QAAiB,KAAK;IAEtB,MAAM,MAAM,GAAc,cAAc,CAAC,CAAC,CAAC,EAAE,GAAG,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAEtE,2BAA2B;IAC3B,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACvB,MAAM,CAAC,UAAU,GAAG,EAAE,CAAC;IACzB,CAAC;IAED,8BAA8B;IAC9B,MAAM,iBAAiB,GAAG,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC;IAE1D,IAAI,iBAAiB,IAAI,CAAC,KAAK,EAAE,CAAC;QAChC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IACvC,CAAC;IAED,2BAA2B;IAC3B,MAAM,CAAC,UAAU,GAAG;QAClB,GAAG,MAAM,CAAC,UAAU;QACpB,CAAC,UAAU,CAAC,EAAE,YAAY;KAC3B,CAAC;IAEF,MAAM,MAAM,GAAG,cAAc,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,UAAkB,EAAE,MAAiB;IAC/D,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEhC,uCAAuC;IACvC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAChD,aAAa,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC"}

package/dist/install/constants.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Constants and client definitions for the install command
+ */
+import type { ClientConfig, McpServerConfig } from './types.js';
+/**
+ * Supported MCP clients with their config locations
+ */
+export declare const CLIENTS: ClientConfig[];
+/**
+ * The VTP MCP server configuration to inject
+ */
+export declare function getVtpServerConfig(): McpServerConfig;
+export declare const VTP_SERVER_NAME = "vtp";
+//# sourceMappingURL=constants.d.ts.map

package/dist/install/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/install/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,YAAY,EAqEjC,CAAC;AAEF;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAcpD;AAED,eAAO,MAAM,eAAe,QAAQ,CAAC"}

package/dist/install/constants.js

@@ -0,0 +1,96 @@
+/**
+ * Constants and client definitions for the install command
+ */
+import { homedir } from 'os';
+import { join } from 'path';
+/**
+ * Supported MCP clients with their config locations
+ */
+export const CLIENTS = [
+    {
+        id: 'claude-desktop',
+        name: 'Claude Desktop',
+        description: 'Anthropic\'s desktop app for Claude',
+        paths: {
+            darwin: join(homedir(), 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json'),
+            win32: join(process.env.APPDATA || '', 'Claude', 'claude_desktop_config.json'),
+            linux: join(homedir(), '.config', 'Claude', 'claude_desktop_config.json'),
+        },
+        restartInstructions: 'Quit and restart Claude Desktop',
+    },
+    {
+        id: 'claude-code',
+        name: 'Claude Code',
+        description: 'Anthropic\'s CLI tool for Claude',
+        paths: {
+            darwin: join(homedir(), '.claude.json'),
+            win32: join(homedir(), '.claude.json'),
+            linux: join(homedir(), '.claude.json'),
+        },
+        restartInstructions: 'Start a new Claude Code session',
+    },
+    {
+        id: 'cursor',
+        name: 'Cursor',
+        description: 'AI-powered code editor',
+        paths: {
+            darwin: join(homedir(), '.cursor', 'mcp.json'),
+            win32: join(homedir(), '.cursor', 'mcp.json'),
+            linux: join(homedir(), '.cursor', 'mcp.json'),
+        },
+        restartInstructions: 'Restart Cursor',
+    },
+    {
+        id: 'project',
+        name: 'Project (.mcp.json)',
+        description: 'Project-level config in current directory',
+        paths: {
+            darwin: join(process.cwd(), '.mcp.json'),
+            win32: join(process.cwd(), '.mcp.json'),
+            linux: join(process.cwd(), '.mcp.json'),
+        },
+        projectLevel: true,
+        restartInstructions: 'Restart your AI coding assistant',
+    },
+    {
+        id: 'vscode',
+        name: 'VS Code',
+        description: 'Project-level MCP config for VS Code',
+        paths: {
+            darwin: join(process.cwd(), '.vscode', 'mcp.json'),
+            win32: join(process.cwd(), '.vscode', 'mcp.json'),
+            linux: join(process.cwd(), '.vscode', 'mcp.json'),
+        },
+        projectLevel: true,
+        restartInstructions: 'Reload VS Code window (Cmd/Ctrl+Shift+P → "Reload Window")',
+    },
+    {
+        id: 'windsurf',
+        name: 'Windsurf',
+        description: 'Codeium\'s AI code editor',
+        paths: {
+            darwin: join(homedir(), '.codeium', 'windsurf', 'mcp_config.json'),
+            win32: join(homedir(), '.codeium', 'windsurf', 'mcp_config.json'),
+            linux: join(homedir(), '.codeium', 'windsurf', 'mcp_config.json'),
+        },
+        restartInstructions: 'Restart Windsurf',
+    },
+];
+/**
+ * The VTP MCP server configuration to inject
+ */
+export function getVtpServerConfig() {
+    const isWindows = process.platform === 'win32';
+    if (isWindows) {
+        return {
+            command: 'cmd',
+            args: ['/c', 'npx', '-y', '@myvtp/mcp'],
+        };
+    }
+    return {
+        command: 'npx',
+        args: ['-y', '@myvtp/mcp'],
+    };
+}
+export const VTP_SERVER_NAME = 'vtp';
+//# sourceMappingURL=constants.js.map

package/dist/install/constants.js.map

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

package/dist/install/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Install command - configures VTP MCP server for AI coding clients
+ */
+/**
+ * Main install command
+ */
+export default function install(args: string[]): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/install/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/install/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmLH;;GAEG;AACH,wBAA8B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsGnE"}

package/dist/install/index.js

@@ -0,0 +1,249 @@
+/**
+ * Install command - configures VTP MCP server for AI coding clients
+ */
+import { checkbox, confirm } from '@inquirer/prompts';
+import pc from 'picocolors';
+import { detectAllClients, filterClients, getClientById } from './clients.js';
+import { mergeVtpConfig, readConfig, writeConfig } from './config.js';
+import { getVtpServerConfig, VTP_SERVER_NAME } from './constants.js';
+/**
+ * Wrap a cancellable prompt to also cancel on Escape key
+ */
+function withEscapeCancel(prompt) {
+    return new Promise((resolve, reject) => {
+        // Set up escape key listener
+        const onData = (data) => {
+            // Escape key is 0x1b (27) as a single byte
+            if (data.length === 1 && data[0] === 0x1b) {
+                prompt.cancel();
+            }
+        };
+        process.stdin.on('data', onData);
+        prompt
+            .then(resolve)
+            .catch(reject)
+            .finally(() => {
+            process.stdin.off('data', onData);
+        });
+    });
+}
+/**
+ * Parse CLI arguments into install options
+ */
+function parseArgs(args) {
+    const options = {};
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--yes' || arg === '-y') {
+            options.yes = true;
+        }
+        else if (arg === '--force' || arg === '-f') {
+            options.force = true;
+        }
+        else if (!arg.startsWith('-')) {
+            // Client ID
+            if (!options.clients) {
+                options.clients = [];
+            }
+            options.clients.push(arg);
+        }
+    }
+    return options;
+}
+/**
+ * Format client choice for the checkbox prompt
+ */
+function formatClientChoice(detected) {
+    const { client, configExists, vtpConfigured, configPath } = detected;
+    let status = '';
+    let checked = true;
+    if (vtpConfigured) {
+        status = pc.yellow(' (already configured)');
+        checked = false;
+    }
+    else if (configExists) {
+        status = pc.dim(' (will update config)');
+    }
+    else if (client.projectLevel) {
+        status = pc.dim(` (will create ${configPath})`);
+        checked = false; // Don't auto-select project-level configs
+    }
+    else {
+        status = pc.dim(' (will create config)');
+    }
+    return {
+        name: `${client.name}${status}`,
+        value: client.id,
+        checked,
+    };
+}
+/**
+ * Configure a single client
+ */
+function configureClient(detected, force) {
+    const { client, configPath, vtpConfigured } = detected;
+    // Skip if already configured and not forcing
+    if (vtpConfigured && !force) {
+        return {
+            client,
+            success: true,
+            action: 'skipped',
+            message: 'VTP already configured',
+        };
+    }
+    try {
+        const existingConfig = readConfig(configPath);
+        const vtpConfig = getVtpServerConfig();
+        const { config, action } = mergeVtpConfig(existingConfig, VTP_SERVER_NAME, vtpConfig, force);
+        if (action === 'skipped') {
+            return {
+                client,
+                success: true,
+                action: 'skipped',
+                message: 'VTP already configured',
+            };
+        }
+        writeConfig(configPath, config);
+        return {
+            client,
+            success: true,
+            action,
+            message: action === 'created' ? 'Created new config with VTP server' : 'Added VTP server to existing config',
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            client,
+            success: false,
+            action: 'error',
+            message,
+        };
+    }
+}
+/**
+ * Print the results summary
+ */
+function printResults(results) {
+    console.log();
+    const successResults = results.filter(r => r.success && r.action !== 'skipped');
+    const skippedResults = results.filter(r => r.action === 'skipped');
+    const errorResults = results.filter(r => !r.success);
+    // Print successes
+    for (const result of successResults) {
+        console.log(`  ${pc.green('✓')} ${result.client.name}: ${result.message}`);
+    }
+    // Print skipped
+    for (const result of skippedResults) {
+        console.log(`  ${pc.yellow('○')} ${result.client.name}: ${result.message}`);
+    }
+    // Print errors
+    for (const result of errorResults) {
+        console.log(`  ${pc.red('✗')} ${result.client.name}: ${result.message}`);
+    }
+    // Print next steps if we configured anything
+    if (successResults.length > 0) {
+        console.log();
+        console.log(pc.bold('  Next steps:'));
+        const restartInstructions = [...new Set(successResults.map(r => r.client.restartInstructions))];
+        restartInstructions.forEach((instruction, i) => {
+            console.log(`  ${i + 1}. ${instruction}`);
+        });
+        console.log();
+        console.log(pc.dim('  Once restarted, ask Claude to "deploy my app" to get started.'));
+    }
+    console.log();
+}
+/**
+ * Main install command
+ */
+export default async function install(args) {
+    const options = parseArgs(args);
+    // Header
+    console.log();
+    console.log(pc.bold('  VTP MCP Server Setup'));
+    console.log(pc.dim('  Configure AI coding assistants to use VTP for deployments'));
+    console.log();
+    // Detect available clients
+    let detected = detectAllClients();
+    if (detected.length === 0) {
+        console.log(pc.yellow('  No supported AI clients detected.'));
+        console.log();
+        console.log('  Supported clients: Claude Desktop, Claude Code, Cursor, VS Code, Windsurf');
+        console.log();
+        return;
+    }
+    // Filter by specified clients if provided
+    if (options.clients && options.clients.length > 0) {
+        // Validate client IDs
+        for (const id of options.clients) {
+            if (!getClientById(id)) {
+                console.log(pc.red(`  Unknown client: ${id}`));
+                console.log();
+                console.log('  Available clients: ' + detected.map(d => d.client.id).join(', '));
+                console.log();
+                return;
+            }
+        }
+        detected = filterClients(detected, options.clients);
+    }
+    let selectedClients;
+    if (options.yes) {
+        // Non-interactive mode: select all (or filtered) clients
+        selectedClients = detected;
+        if (selectedClients.length === 0) {
+            console.log(pc.yellow('  No clients to configure.'));
+            console.log();
+            return;
+        }
+    }
+    else {
+        // Interactive mode: show checkbox prompt
+        const choices = detected.map(formatClientChoice);
+        try {
+            const checkboxPrompt = checkbox({
+                message: 'Select AI clients to configure:',
+                choices,
+                pageSize: 10,
+                required: true,
+            });
+            const selectedIds = await withEscapeCancel(checkboxPrompt);
+            if (selectedIds.length === 0) {
+                console.log(pc.yellow('  No clients selected.'));
+                console.log();
+                return;
+            }
+            selectedClients = filterClients(detected, selectedIds);
+            // Check for already-configured clients and confirm overwrite
+            const alreadyConfigured = selectedClients.filter(c => c.vtpConfigured);
+            if (alreadyConfigured.length > 0 && !options.force) {
+                const names = alreadyConfigured.map(c => c.client.name).join(', ');
+                const confirmPrompt = confirm({
+                    message: `${names} already have VTP configured. Overwrite?`,
+                    default: false,
+                });
+                const shouldOverwrite = await withEscapeCancel(confirmPrompt);
+                if (!shouldOverwrite) {
+                    selectedClients = selectedClients.filter(c => !c.vtpConfigured);
+                }
+                else {
+                    options.force = true;
+                }
+            }
+        }
+        catch {
+            // User cancelled (Ctrl+C or Escape)
+            console.log();
+            return;
+        }
+    }
+    // Configure selected clients
+    const results = [];
+    for (const detected of selectedClients) {
+        const result = configureClient(detected, options.force || false);
+        results.push(result);
+    }
+    // Print results
+    printResults(results);
+}
+//# sourceMappingURL=index.js.map

package/dist/install/index.js.map

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

package/dist/install/types.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Type definitions for the install command
+ */
+export interface ClientConfig {
+    /** Display name for the client */
+    name: string;
+    /** Unique identifier used in CLI args */
+    id: string;
+    /** Description shown in the installer */
+    description: string;
+    /** Config file paths per platform */
+    paths: {
+        darwin?: string;
+        win32?: string;
+        linux?: string;
+    };
+    /** Whether this is a project-level config (like VS Code) */
+    projectLevel?: boolean;
+    /** Restart instructions after configuration */
+    restartInstructions: string;
+}
+export interface DetectedClient {
+    /** Client definition */
+    client: ClientConfig;
+    /** Resolved config path for current platform */
+    configPath: string;
+    /** Whether the config file exists */
+    configExists: boolean;
+    /** Whether VTP is already configured */
+    vtpConfigured: boolean;
+    /** The existing config content (if readable) */
+    existingConfig?: McpConfig;
+}
+export interface McpServerConfig {
+    command: string;
+    args: string[];
+    env?: Record<string, string>;
+}
+export interface McpConfig {
+    mcpServers?: Record<string, McpServerConfig>;
+    [key: string]: unknown;
+}
+export interface InstallOptions {
+    /** Run without prompts, configure all detected clients */
+    yes?: boolean;
+    /** Force overwrite existing VTP config */
+    force?: boolean;
+    /** Specific clients to configure (by id) */
+    clients?: string[];
+}
+export interface InstallResult {
+    client: ClientConfig;
+    success: boolean;
+    action: 'created' | 'updated' | 'skipped' | 'error';
+    message: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/install/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,KAAK,EAAE;QACL,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,4DAA4D;IAC5D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+CAA+C;IAC/C,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,MAAM,EAAE,YAAY,CAAC;IACrB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,YAAY,EAAE,OAAO,CAAC;IACtB,wCAAwC;IACxC,aAAa,EAAE,OAAO,CAAC;IACvB,gDAAgD;IAChD,cAAc,CAAC,EAAE,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC7C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,0CAA0C;IAC1C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IACpD,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/install/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for the install command
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/install/types.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,5 @@
+/**
+ * VTP MCP Server - handles tool requests from AI assistants
+ */
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

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

package/dist/server.js

@@ -0,0 +1,174 @@
+/**
+ * VTP MCP Server - handles tool requests from AI assistants
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { existsSync } from 'fs';
+import * as client from './client.js';
+import { DeploySchema, GuideTypeSchema, toolDefinitions } from './tools.js';
+const server = new Server({
+    name: 'vtp',
+    version: '0.7.0',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// List available tools
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: toolDefinitions,
+}));
+// Handle tool calls - all delegate to HTTP API via client
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case 'list_app_types': {
+                const types = await client.listAppTypes();
+                const typeList = types
+                    .map(t => `- **${t.displayName}** (${t.type})\n  ${t.description}`)
+                    .join('\n');
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `Supported app types:\n\n${typeList}\n\n` +
+                                `Use get_deployment_guide with a type to see detailed instructions.`,
+                        }],
+                };
+            }
+            case 'get_deployment_guide': {
+                const { type: guideType } = GuideTypeSchema.parse(args);
+                try {
+                    const guide = await client.getDeploymentGuide(guideType);
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: guide.content,
+                            }],
+                    };
+                }
+                catch (error) {
+                    if (error instanceof Error && error.message.includes('guide_not_found')) {
+                        const types = await client.listAppTypes();
+                        const available = types.map(t => t.type).join(', ');
+                        return {
+                            content: [{
+                                    type: 'text',
+                                    text: `Unknown app type: "${guideType}"\n\nAvailable types: ${available}`,
+                                }],
+                            isError: true,
+                        };
+                    }
+                    throw error;
+                }
+            }
+            case 'deploy': {
+                const { config, force } = DeploySchema.parse(args);
+                const configPath = config || './vtp.yaml';
+                // Validate config exists
+                if (!existsSync(configPath)) {
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: `Error: Config file not found: ${configPath}\n\n` +
+                                    `Create a vtp.yaml file with:\n` +
+                                    `  name: My App Name      # Display name\n` +
+                                    `  id: my-app             # Optional: URL slug\n` +
+                                    `  type: static           # or "node"\n` +
+                                    `  path: ./dist           # folder to deploy\n\n` +
+                                    `Use list_app_types and get_deployment_guide for help.`,
+                            }],
+                        isError: true,
+                    };
+                }
+                // Deploy via HTTP API
+                const result = await client.deploy(configPath, force ?? false);
+                // Handle conflict
+                if (result.error === 'conflict') {
+                    const existingApp = result.existingApp;
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: `App '${existingApp?.id}' already exists at ${existingApp?.url || 'unknown URL'}\n` +
+                                    `Name: ${existingApp?.name || 'unknown'}\n` +
+                                    `Status: ${existingApp?.status || 'unknown'}\n\n` +
+                                    `Use force: true to replace it.`,
+                            }],
+                    };
+                }
+                // Handle other errors
+                if (result.error) {
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: `Error: ${result.message || result.error}`,
+                            }],
+                        isError: true,
+                    };
+                }
+                // Success
+                const app = result.app;
+                const prefix = result.replaced ? 'Replaced' : 'Deployed';
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `${prefix} ${app.name} (@${app.id})\n` +
+                                `  URL: ${app.url}\n` +
+                                `  Type: ${app.type}\n` +
+                                `  Status: ${app.status}`,
+                        }],
+                };
+            }
+            case 'list': {
+                const apps = await client.listApps();
+                if (apps.length === 0) {
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: 'No apps deployed yet.',
+                            }],
+                    };
+                }
+                const appList = apps
+                    .map(app => {
+                    const desc = app.description ? `\n  ${app.description}` : '';
+                    return `- ${app.name} (@${app.id}) - ${app.type} - ${app.status}${desc}\n  ${app.url}`;
+                })
+                    .join('\n');
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `Deployed apps:\n${appList}`,
+                        }],
+                };
+            }
+            default:
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `Unknown tool: ${name}`,
+                        }],
+                    isError: true,
+                };
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Error: ${message}`,
+                }],
+            isError: true,
+        };
+    }
+});
+// Start the server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('VTP MCP server running on stdio');
+}
+main().catch(console.error);
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myvtp/mcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "MCP server for VTP - deploy apps via Claude Code",
   "type": "module",
   "main": "dist/index.js",
@@ -32,9 +32,11 @@
   },
   "homepage": "https://github.com/myvtp/mcp#readme",
   "dependencies": {
+    "@inquirer/prompts": "^7.0.0",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "form-data": "^4.0.0",
     "ignore": "^7.0.5",
+    "picocolors": "^1.1.0",
     "tar": "^7.5.7",
     "yaml": "^2.8.2",
     "zod": "^3.22.4"