composter-cli 1.0.6 → 1.0.8

package/README.md

@@ -314,48 +314,46 @@ npm dependencies are tracked with versions from your `package.json`:
 
 ## 🤖 AI Integration (MCP)
 
-Composter includes a built-in Model Context Protocol (MCP) server that lets AI assistants interact with your vault directly.
+Let AI assistants like **Claude**, **Cursor**, and **GitHub Copilot** access your vault via MCP.
 
-### Quick Setup
+### One-Command Setup
 
-```bash
-# One command to configure your AI assistant
-npx composter-cli@latest mcp init --client claude
-```
-
-**Supported clients:**
-- `claude` — Claude Desktop
-- `cursor` — Cursor IDE
-- `vscode` — VS Code with Copilot
-- `windsurf` — Windsurf IDE
-
-### MCP Commands
-
-| Command | Description |
-|---------|-------------|
-| `composter mcp init --client <name>` | Configure MCP for an AI assistant |
-| `composter mcp serve` | Start MCP server directly (testing) |
-| `composter mcp info` | Show MCP configuration info |
-
-### Options
+Login once, then auto-configure your IDE/assistant:
 
 ```bash
-# Configure for Claude Desktop
-composter mcp init --client claude
+# Login (if you haven't)
+composter login
 
-# Configure for Cursor
-composter mcp init --client cursor
+# Auto-configure (pick one)
+npx composter-mcp init claude   # Claude Desktop
+npx composter-mcp init cursor   # Cursor
+npx composter-mcp init vscode   # VS Code (Copilot)
+npx composter-mcp init windsurf # Windsurf
+```
 
-# Use localhost backend (development)
-composter mcp init --client claude --dev
+Then restart your AI assistant — done!
 
-# Show manual config instructions
-composter mcp info
+#### Manual config (if you prefer)
+```json
+{
+  "mcpServers": {
+    "composter": {
+      "command": "npx",
+      "args": ["composter-mcp"]
+    }
+  }
+}
 ```
 
-### Available AI Tools
+Config file locations:
+- Cursor: `.cursor/mcp.json` (project root)
+- VS Code: `.vscode/mcp.json` (project root)
+- Claude Desktop (Linux): `~/.config/claude/claude_desktop_config.json`
+- Claude Desktop (macOS): `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Claude Desktop (Windows): `%APPDATA%\\Claude\\claude_desktop_config.json`
+- Windsurf: `~/.codeium/windsurf/mcp_config.json`
 
-Once configured, your AI assistant can use these tools:
+### Available AI Tools
 
 | Tool | Description |
 |------|-------------|
@@ -364,25 +362,13 @@ Once configured, your AI assistant can use these tools:
 | `list_components` | List components in a category |
 | `read_component` | Read full source code of a component |
 
-### Example AI Prompts
+### Example Prompts
 
-After setup, you can ask your AI:
 - *"Search my Composter vault for button components"*
 - *"What categories do I have in Composter?"*
 - *"Read the DataTable component from my ui category"*
-- *"List all components in my hooks category"*
 
-### Development Mode
-
-For local development with `localhost:3000` backend:
-
-```bash
-# Initialize with dev flag
-composter mcp init --client claude --dev
-
-# Or set environment variable
-COMPOSTER_DEV=true composter mcp serve
-```
+📖 [Full MCP Documentation](https://www.npmjs.com/package/composter-mcp)
 
 ---
 

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "composter-cli",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "type": "module",
-  "description": "Your personal vault for React components. Push, pull, and sync reusable components across projects — like shadcn/ui but for YOUR code. Includes MCP server for AI assistants.",
+  "description": "Your personal vault for React components. Push, pull, and sync reusable components across projects — like shadcn/ui but for YOUR code.",
   "main": "src/index.js",
   "bin": {
     "composter": "./bin/composter.js"
@@ -20,13 +20,7 @@
     "component-library",
     "code-sharing",
     "developer-tools",
-    "productivity",
-    "mcp",
-    "ai-tools",
-    "claude",
-    "cursor",
-    "copilot",
-    "model-context-protocol"
+    "productivity"
   ],
   "author": "binit2-1",
   "license": "MIT",
@@ -42,11 +36,9 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.23.0",
     "commander": "^14.0.2",
     "dotenv": "^16.4.5",
     "inquirer": "^13.0.1",
-    "node-fetch": "^3.3.2",
-    "zod": "^3.23.0"
+    "node-fetch": "^3.3.2"
   }
 }

package/src/index.js

@@ -6,7 +6,6 @@ import { mkcat } from "./commands/mkcat.js";
 import { listCategories } from "./commands/listCat.js";
 import { pushComponent } from "./commands/push.js";
 import { pullComponent } from "./commands/pull.js";
-import { mcpInit, mcpServe, mcpInfo } from "./commands/mcp.js";
 import { createRequire } from "module";
 
 const require = createRequire(import.meta.url);
@@ -50,34 +49,4 @@ program
     pullComponent(category, title, filepath);
   });
 
-// MCP Commands
-const mcp = program
-  .command("mcp")
-  .description("Manage MCP (Model Context Protocol) server for AI assistants");
-
-mcp
-  .command("init")
-  .description("Initialize MCP server for an AI assistant")
-  .option("-c, --client <client>", "AI client to configure (claude, cursor, vscode, windsurf)", "claude")
-  .option("-g, --global", "Configure globally instead of project-specific")
-  .option("-d, --dev", "Use localhost:3000 backend (development mode)")
-  .action((options) => {
-    mcpInit(options.client, options);
-  });
-
-mcp
-  .command("serve")
-  .description("Start the MCP server directly (for testing)")
-  .option("-d, --dev", "Use localhost:3000 backend (development mode)")
-  .action((options) => {
-    mcpServe(options);
-  });
-
-mcp
-  .command("info")
-  .description("Show MCP configuration information")
-  .action(() => {
-    mcpInfo();
-  });
-
 program.parse(process.argv);

package/src/commands/mcp.js

@@ -1,238 +0,0 @@
-import fs from "fs";
-import path from "path";
-import os from "os";
-import { loadSession } from "../utils/session.js";
-import { fileURLToPath } from "url";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-// Get the path to the MCP server script
-function getMcpServerPath() {
-  return path.resolve(__dirname, "../mcp/server.js");
-}
-
-// Client configuration templates
-const CLIENT_CONFIGS = {
-  claude: {
-    name: "Claude Desktop",
-    configPath: () => {
-      if (process.platform === "darwin") {
-        return path.join(os.homedir(), "Library", "Application Support", "Claude", "claude_desktop_config.json");
-      } else if (process.platform === "win32") {
-        return path.join(process.env.APPDATA, "Claude", "claude_desktop_config.json");
-      } else {
-        return path.join(os.homedir(), ".config", "claude", "claude_desktop_config.json");
-      }
-    },
-    generateConfig: (serverPath, cwd) => ({
-      mcpServers: {
-        composter: {
-          command: "node",
-          args: [serverPath],
-          cwd: cwd,
-        },
-      },
-    }),
-  },
-  cursor: {
-    name: "Cursor",
-    configPath: () => {
-      return path.join(process.cwd(), ".cursor", "mcp.json");
-    },
-    generateConfig: (serverPath, cwd) => ({
-      composter: {
-        command: "node",
-        args: [serverPath],
-        cwd: cwd,
-      },
-    }),
-  },
-  vscode: {
-    name: "VS Code (Copilot)",
-    configPath: () => {
-      return path.join(process.cwd(), ".vscode", "mcp.json");
-    },
-    generateConfig: (serverPath, cwd) => ({
-      servers: {
-        composter: {
-          command: "node",
-          args: [serverPath],
-          cwd: cwd,
-        },
-      },
-    }),
-  },
-  windsurf: {
-    name: "Windsurf",
-    configPath: () => {
-      return path.join(os.homedir(), ".codeium", "windsurf", "mcp_config.json");
-    },
-    generateConfig: (serverPath, cwd) => ({
-      mcpServers: {
-        composter: {
-          command: "node",
-          args: [serverPath],
-          cwd: cwd,
-        },
-      },
-    }),
-  },
-};
-
-// Initialize MCP for a specific client
-export async function mcpInit(client, options = {}) {
-  // Validate client
-  const clientConfig = CLIENT_CONFIGS[client?.toLowerCase()];
-  if (!clientConfig) {
-    console.log(`❌ Unknown client: ${client}`);
-    console.log(`\nSupported clients:`);
-    Object.entries(CLIENT_CONFIGS).forEach(([key, val]) => {
-      console.log(`  - ${key} (${val.name})`);
-    });
-    return;
-  }
-
-  // Check if user is logged in
-  const session = loadSession();
-  if (!session?.jwt) {
-    console.log("❌ You must be logged in first. Run: composter login");
-    return;
-  }
-
-  const serverPath = getMcpServerPath();
-  const cwd = options.global ? path.dirname(serverPath) : process.cwd();
-  const configPath = clientConfig.configPath();
-  const configDir = path.dirname(configPath);
-
-  console.log(`\n🔧 Setting up Composter MCP for ${clientConfig.name}...\n`);
-
-  // Generate the config snippet
-  const newConfig = clientConfig.generateConfig(serverPath, cwd);
-
-  // Check if config file exists
-  let existingConfig = {};
-  if (fs.existsSync(configPath)) {
-    try {
-      existingConfig = JSON.parse(fs.readFileSync(configPath, "utf-8"));
-      console.log(`📄 Found existing config at: ${configPath}`);
-    } catch {
-      console.log(`⚠️  Existing config is invalid, will create new one.`);
-    }
-  }
-
-  // Merge configs
-  let mergedConfig;
-  if (client === "claude" || client === "windsurf") {
-    mergedConfig = {
-      ...existingConfig,
-      mcpServers: {
-        ...existingConfig.mcpServers,
-        ...newConfig.mcpServers,
-      },
-    };
-  } else if (client === "vscode") {
-    mergedConfig = {
-      ...existingConfig,
-      servers: {
-        ...existingConfig.servers,
-        ...newConfig.servers,
-      },
-    };
-  } else {
-    // Cursor - direct merge
-    mergedConfig = {
-      ...existingConfig,
-      ...newConfig,
-    };
-  }
-
-  // Create directory if needed
-  if (!fs.existsSync(configDir)) {
-    fs.mkdirSync(configDir, { recursive: true });
-    console.log(`📁 Created directory: ${configDir}`);
-  }
-
-  // Write config
-  fs.writeFileSync(configPath, JSON.stringify(mergedConfig, null, 2), "utf-8");
-  console.log(`✅ Config written to: ${configPath}`);
-
-  // Print success message
-  console.log(`
-╔════════════════════════════════════════════════════════════════╗
-║                    🎉 MCP Setup Complete!                      ║
-╠════════════════════════════════════════════════════════════════╣
-║                                                                ║
-║  Composter MCP server has been configured for ${clientConfig.name.padEnd(14)}  ║
-║                                                                ║
-║  Next steps:                                                   ║
-║  1. Restart ${clientConfig.name.padEnd(50)} ║
-║  2. Look for "Composter" in your MCP tools                     ║
-║                                                                ║
-║  Available tools:                                              ║
-║  • search_components - Search your component vault             ║
-║  • list_categories   - List all your categories                ║
-║  • list_components   - List components in a category           ║
-║  • read_component    - Read full source code                   ║
-║                                                                ║
-╚════════════════════════════════════════════════════════════════╝
-`);
-
-  // Dev mode hint
-  if (options.dev) {
-    console.log(`\n💡 Dev mode: Set COMPOSTER_DEV=true to use localhost:3000`);
-  }
-}
-
-// Serve MCP server directly (for testing)
-export async function mcpServe(options = {}) {
-  const session = loadSession();
-  if (!session?.jwt) {
-    console.log("❌ You must be logged in first. Run: composter login");
-    return;
-  }
-
-  console.log("🚀 Starting Composter MCP server...");
-  console.log("   Press Ctrl+C to stop\n");
-
-  // Set dev mode if requested
-  if (options.dev) {
-    process.env.COMPOSTER_DEV = "true";
-    console.log("📡 Dev mode: Using localhost:3000");
-  }
-
-  // Dynamic import and run the server
-  const serverPath = getMcpServerPath();
-  await import(serverPath);
-}
-
-// Show MCP configuration info
-export function mcpInfo() {
-  const serverPath = getMcpServerPath();
-  const session = loadSession();
-
-  console.log(`
-╔════════════════════════════════════════════════════════════════╗
-║                  Composter MCP Information                     ║
-╠════════════════════════════════════════════════════════════════╣
-
-  Server path:  ${serverPath}
-  Logged in:    ${session?.jwt ? "✅ Yes" : "❌ No (run 'composter login')"}
-  
-  Manual configuration:
-  
-  {
-    "composter": {
-      "command": "node",
-      "args": ["${serverPath}"]
-    }
-  }
-
-  Environment variables:
-  • COMPOSTER_DEV=true     - Use localhost:3000 backend
-  • COMPOSTER_API_URL=...  - Custom API URL
-
-╚════════════════════════════════════════════════════════════════╝
-`);
-}
-

package/src/mcp/server.js

@@ -1,289 +0,0 @@
-#!/usr/bin/env node
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z } from "zod";
-import { loadSession } from "../utils/session.js";
-import fetch from "node-fetch";
-
-// Redirect console.log to stderr (MCP uses stdout for protocol)
-const originalLog = console.log;
-console.log = (...args) => console.error(...args);
-
-// Determine base URL - supports both dev and production
-function getBaseUrl() {
-  // Check for explicit env var first
-  if (process.env.COMPOSTER_API_URL) {
-    return process.env.COMPOSTER_API_URL;
-  }
-  // Check for dev mode
-  if (process.env.COMPOSTER_DEV === "true" || process.env.NODE_ENV === "development") {
-    return "http://localhost:3000/api";
-  }
-  // Default to production
-  return "https://composter.onrender.com/api";
-}
-
-const BASE_URL = getBaseUrl();
-
-// API request helper with JWT auth
-async function apiRequest(path, options = {}) {
-  const session = loadSession();
-  
-  if (!session?.jwt) {
-    throw new Error("Not authenticated. Run 'composter login' first.");
-  }
-
-  const headers = {
-    "Content-Type": "application/json",
-    "Authorization": `Bearer ${session.jwt}`,
-    ...options.headers,
-  };
-
-  const res = await fetch(`${BASE_URL}${path}`, {
-    ...options,
-    headers,
-  });
-
-  if (res.status === 401) {
-    throw new Error("Session expired. Run 'composter login' again.");
-  }
-
-  return res;
-}
-
-// Create the MCP server with tools
-function createComposterMcpServer() {
-  const server = new McpServer({
-    name: "Composter",
-    version: "1.0.0",
-  });
-
-  // Tool: Search components
-  server.tool(
-    "search_components",
-    "Search for React components in your Composter vault by title or category name. Returns matching components with IDs and categories.",
-    {
-      query: z.string().describe("Search term for component title or category name"),
-    },
-    async ({ query }) => {
-      try {
-        const res = await apiRequest(`/components/search?q=${encodeURIComponent(query)}`, { method: "GET" });
-        
-        if (!res.ok) {
-          const error = await res.json().catch(() => ({}));
-          return {
-            content: [{ type: "text", text: `Error searching: ${error.message || res.statusText}` }],
-          };
-        }
-
-        const data = await res.json();
-        const components = data.components || [];
-
-        if (components.length === 0) {
-          return {
-            content: [{ type: "text", text: "No components found matching that query." }],
-          };
-        }
-
-        const formatted = components.map((c) =>
-          `- **${c.title}** (Category: ${c.category?.name || "unknown"}) [ID: ${c.id}]`
-        ).join("\n");
-
-        return {
-          content: [{ type: "text", text: `Found ${components.length} component(s):\n\n${formatted}` }],
-        };
-      } catch (err) {
-        return {
-          content: [{ type: "text", text: `Error: ${err.message}` }],
-        };
-      }
-    }
-  );
-
-  // Tool: List categories
-  server.tool(
-    "list_categories",
-    "List all categories in your Composter vault.",
-    {},
-    async () => {
-      try {
-        const res = await apiRequest("/categories");
-        
-        if (!res.ok) {
-          const error = await res.json().catch(() => ({}));
-          return {
-            content: [{ type: "text", text: `Error: ${error.message || res.statusText}` }],
-          };
-        }
-
-        const data = await res.json();
-        const categories = data.categories || [];
-
-        if (categories.length === 0) {
-          return {
-            content: [{ type: "text", text: "No categories found. Create one with 'composter mkcat <name>'." }],
-          };
-        }
-
-        const formatted = categories.map((c) => `- ${c.name}`).join("\n");
-
-        return {
-          content: [{ type: "text", text: `Your categories:\n\n${formatted}` }],
-        };
-      } catch (err) {
-        return {
-          content: [{ type: "text", text: `Error: ${err.message}` }],
-        };
-      }
-    }
-  );
-
-  // Tool: Read component
-  server.tool(
-    "read_component",
-    "Read the full source code of a React component from your vault. Returns the code, category, dependencies, and creation date.",
-    {
-      category: z.string().describe("The category name the component belongs to"),
-      title: z.string().describe("The title/name of the component to read"),
-    },
-    async ({ category, title }) => {
-      try {
-        const res = await apiRequest(
-          `/components?category=${encodeURIComponent(category)}&title=${encodeURIComponent(title)}`
-        );
-
-        if (res.status === 404) {
-          return {
-            content: [{ type: "text", text: `Component "${title}" not found in category "${category}".` }],
-          };
-        }
-
-        if (!res.ok) {
-          const error = await res.json().catch(() => ({}));
-          return {
-            content: [{ type: "text", text: `Error: ${error.message || res.statusText}` }],
-          };
-        }
-
-        const data = await res.json();
-        const component = data.component;
-
-        if (!component) {
-          return {
-            content: [{ type: "text", text: `Component "${title}" not found.` }],
-          };
-        }
-
-        // Parse code - could be JSON (multi-file) or string (single file)
-        let codeOutput = "";
-        try {
-          const files = JSON.parse(component.code);
-          codeOutput = Object.entries(files)
-            .map(([path, content]) => `### ${path}\n\`\`\`tsx\n${content}\n\`\`\``)
-            .join("\n\n");
-        } catch {
-          codeOutput = `\`\`\`tsx\n${component.code}\n\`\`\``;
-        }
-
-        // Format dependencies
-        let depsOutput = "";
-        if (component.dependencies && Object.keys(component.dependencies).length > 0) {
-          const deps = Object.entries(component.dependencies)
-            .map(([pkg, ver]) => `- ${pkg}: ${ver}`)
-            .join("\n");
-          depsOutput = `\n\n**Dependencies:**\n${deps}`;
-        }
-
-        const output = `# ${component.title}
-
-**Category:** ${category}
-**Created:** ${new Date(component.createdAt).toLocaleDateString()}
-${depsOutput}
-
-## Source Code
-
-${codeOutput}`;
-
-        return {
-          content: [{ type: "text", text: output }],
-        };
-      } catch (err) {
-        return {
-          content: [{ type: "text", text: `Error: ${err.message}` }],
-        };
-      }
-    }
-  );
-
-  // Tool: List components in category
-  server.tool(
-    "list_components",
-    "List all components in a specific category.",
-    {
-      category: z.string().describe("The category name to list components from"),
-    },
-    async ({ category }) => {
-      try {
-        const res = await apiRequest(`/components/list-by-category?category=${encodeURIComponent(category)}`, { method: "GET" });
-        
-        if (!res.ok) {
-          const error = await res.json().catch(() => ({}));
-          return {
-            content: [{ type: "text", text: `Error: ${error.message || res.statusText}` }],
-          };
-        }
-
-        const data = await res.json();
-        const components = data.components || [];
-
-        if (components.length === 0) {
-          return {
-            content: [{ type: "text", text: `No components found in category "${category}".` }],
-          };
-        }
-
-        const formatted = components.map((c) => 
-          `- **${c.title}** (created: ${new Date(c.createdAt).toLocaleDateString()})`
-        ).join("\n");
-
-        return {
-          content: [{ type: "text", text: `Components in "${category}":\n\n${formatted}` }],
-        };
-      } catch (err) {
-        return {
-          content: [{ type: "text", text: `Error: ${err.message}` }],
-        };
-      }
-    }
-  );
-
-  return server;
-}
-
-// Main entry point
-async function main() {
-  try {
-    // Verify session exists
-    const session = loadSession();
-    if (!session?.jwt) {
-      console.error("❌ No session found. Please run 'composter login' first.");
-      process.exit(1);
-    }
-
-    console.error(`🚀 Composter MCP Server starting...`);
-    console.error(`📡 API: ${BASE_URL}`);
-
-    const server = createComposterMcpServer();
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-
-    console.error("✅ Composter MCP server running on stdio");
-  } catch (error) {
-    console.error("❌ Fatal Error:", error.message);
-    process.exit(1);
-  }
-}
-
-// Run if called directly
-main();
-