kiviui-mcp 1.0.0 → 1.0.2

package/dist/index.d.ts

@@ -1 +1,2 @@
+#!/usr/bin/env node
 export {};

package/dist/index.js

@@ -1,7 +1,10 @@
+#!/usr/bin/env node
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { registerTools } from "./tools/index.js";
-async function main() {
+import { program } from "commander";
+import { installForClient } from "./install.js";
+async function runServer() {
     const server = new McpServer({
         name: "Kivi UI Local MCP",
         version: "1.0.0",
@@ -12,7 +15,31 @@ async function main() {
     await server.connect(transport);
     console.error("Kivi UI Local MCP Server running on stdio");
 }
-main().catch((error) => {
-    console.error("Server error:", error);
-    process.exit(1);
+program
+    .name("kiviui-mcp")
+    .description("CLI and MCP Server for Kivi UI");
+program
+    .command("install <client>")
+    .description("Install MCP server configuration for a specific client (claude, cursor, vscode, antigravity)")
+    .action(async (client) => {
+    try {
+        await installForClient(client);
+    }
+    catch (err) {
+        console.error(`Failed to install for ${client}:`, err);
+        process.exit(1);
+    }
 });
+program
+    .command("start", { isDefault: true })
+    .description("Start the MCP server (default)")
+    .action(async () => {
+    try {
+        await runServer();
+    }
+    catch (error) {
+        console.error("Server error:", error);
+        process.exit(1);
+    }
+});
+program.parse(process.argv);

package/dist/install.d.ts

@@ -0,0 +1 @@
+export declare function installForClient(client: string): Promise<void>;

package/dist/install.js

@@ -0,0 +1,105 @@
+import fs from "fs/promises";
+import path from "path";
+import os from "os";
+// Helper to determine OS
+const isWindows = os.platform() === "win32";
+const isMac = os.platform() === "darwin";
+// Command to run the MCP server
+// npx -y kiviui-mcp
+const MCP_SERVER_COMMAND = "npx";
+const MCP_SERVER_ARGS = ["-y", "kiviui-mcp"];
+async function updateJsonConfig(configPath, serverName, command, args) {
+    let config = { mcpServers: {} };
+    try {
+        const fileContent = await fs.readFile(configPath, "utf-8");
+        config = JSON.parse(fileContent);
+    }
+    catch (err) {
+        if (err.code !== "ENOENT") {
+            throw err;
+        }
+        // File doesn't exist, will be created
+    }
+    if (!config.mcpServers) {
+        config.mcpServers = {};
+    }
+    config.mcpServers[serverName] = {
+        command,
+        args
+    };
+    await fs.mkdir(path.dirname(configPath), { recursive: true });
+    await fs.writeFile(configPath, JSON.stringify(config, null, 2));
+    console.log(`✅ Successfully updated configuration at: ${configPath}`);
+    console.log(`Added MCP server: ${serverName}`);
+}
+export async function installForClient(client) {
+    const normalizedClient = client.toLowerCase();
+    const serverName = "kivi-ui";
+    const homeDir = os.homedir();
+    switch (normalizedClient) {
+        case "claude": {
+            let configPath = "";
+            if (isMac) {
+                configPath = path.join(homeDir, "Library", "Application Support", "Claude", "claude_desktop_config.json");
+            }
+            else if (isWindows) {
+                configPath = path.join(process.env.APPDATA || path.join(homeDir, "AppData", "Roaming"), "Claude", "claude_desktop_config.json");
+            }
+            else {
+                // Linux (Unofficial)
+                configPath = path.join(homeDir, ".config", "Claude", "claude_desktop_config.json");
+            }
+            await updateJsonConfig(configPath, serverName, MCP_SERVER_COMMAND, MCP_SERVER_ARGS);
+            console.log("Please restart Claude Desktop for the changes to take effect.");
+            break;
+        }
+        case "cursor": {
+            // Cursor doesn't have a standard global json for this yet, but we can instruct the user
+            // or try to update a known cursor path if it exists. 
+            // For now, let's just give instructions since cursor configuration is often project-specific or manual in UI.
+            console.log("To use Kivi UI MCP in Cursor:");
+            console.log("1. Open Cursor Settings (Cursor Settings > Features > MCP)");
+            console.log("2. Click '+ Add New MCP Server'");
+            console.log("3. Type: command");
+            console.log(`4. Name: ${serverName}`);
+            console.log(`5. Command: ${MCP_SERVER_COMMAND} ${MCP_SERVER_ARGS.join(" ")}`);
+            break;
+        }
+        case "vscode": {
+            // VSCode doesn't have native MCP support yet without extensions like Cline or Roo.
+            // We will provide instructions for Cline.
+            let configPath = "";
+            if (isMac) {
+                configPath = path.join(homeDir, "Library", "Application Support", "Code", "User", "globalStorage", "saoudrizwan.claude-dev", "settings", "cline_mcp_settings.json");
+            }
+            else if (isWindows) {
+                configPath = path.join(process.env.APPDATA || path.join(homeDir, "AppData", "Roaming"), "Code", "User", "globalStorage", "saoudrizwan.claude-dev", "settings", "cline_mcp_settings.json");
+            }
+            else {
+                configPath = path.join(homeDir, ".config", "Code", "User", "globalStorage", "saoudrizwan.claude-dev", "settings", "cline_mcp_settings.json");
+            }
+            try {
+                await updateJsonConfig(configPath, serverName, MCP_SERVER_COMMAND, MCP_SERVER_ARGS);
+                console.log("Successfully configured Kivi UI MCP for Cline/Roo Code in VS Code.");
+            }
+            catch (err) {
+                console.log("Could not find Cline MCP config. To configure manually in VS Code:");
+                console.log(`Command: ${MCP_SERVER_COMMAND} ${MCP_SERVER_ARGS.join(" ")}`);
+            }
+            break;
+        }
+        case "antigravity":
+        case "agy": {
+            // Antigravity MCP config
+            const configPath = path.join(homeDir, ".gemini", "config", "mcp_config.json");
+            await updateJsonConfig(configPath, serverName, MCP_SERVER_COMMAND, MCP_SERVER_ARGS);
+            console.log("Successfully configured Kivi UI MCP for Antigravity.");
+            break;
+        }
+        default: {
+            console.error(`Unknown client: ${client}`);
+            console.log("Supported clients: claude, cursor, vscode, antigravity");
+            process.exit(1);
+        }
+    }
+}

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "kiviui-mcp",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Local MCP server for Kivi UI designed for Claude Desktop and VS Code",
   "type": "module",
   "main": "./dist/index.js",
   "bin": {
-    "kiviui-local-mcp": "dist/index.js"
+    "kiviui-mcp": "dist/index.js"
   },
   "files": [
     "dist"
@@ -17,6 +17,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
+    "commander": "^14.0.3",
     "zod": "^3.23.8"
   },
   "devDependencies": {