@sk-labs/copilot-kit 3.0.5 → 3.0.6

package/bin/copilot-kit.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 const { program } = require('commander');
-const { init, update, status } = require('../lib/commands');
+const { init, update, status, mcp } = require('../lib/commands');
 const pkg = require('../package.json');
 
 program
@@ -28,8 +28,18 @@ program
 
 program
   .command('status')
-  .description('Check installation status')
-  .option('-p, --path <path>', 'Project directory', '.')
-  .action(status);
+  .description('Check Copilot Kit status')
+  .option('-p, --path <path>', 'Path to project root', '.')
+  .action((options) => {
+    status(options);
+  });
+
+program
+  .command('mcp [action] [target]')
+  .description('Manage MCP servers (install, list)')
+  .option('-p, --path <path>', 'Path to project root', '.')
+  .action((action, target, options) => {
+    mcp({ ...options, action, target });
+  });
 
-program.parse();
+program.parse(process.argv); // Changed to pass process.argv

package/lib/commands.js

@@ -9,6 +9,35 @@ const readline = require('readline');
 const GITHUB_REPO = 'sk-labs/copilot-kit';
 const GITHUB_API = 'https://api.github.com';
 
+const McpManager = require('../mcp-manager');
+
+async function mcp(options) {
+  const manager = new McpManager(options.path);
+  const action = options.action; // 'install' | 'list'
+  const target = options.target; // server name
+
+  console.log(chalk.bold.blue('\n🔌 Copilot Kit MCP Manager\n'));
+
+  if (action === 'list') {
+    manager.list();
+    return;
+  }
+
+  if (action === 'install') {
+    if (!target) {
+      console.error(chalk.red('❌ Error: Missing server name. Usage: copilot-kit mcp install <server>'));
+      process.exit(1);
+    }
+    // Separate extra args if passed (basic mechanism, might need commander parsing enhancement later)
+    // For now, allow simple install
+    const success = manager.install(target);
+    if (!success) process.exit(1);
+    return;
+  }
+
+  console.log(chalk.yellow('Usage: copilot-kit mcp [install <server> | list]'));
+}
+
 async function init(options) {
   const targetPath = path.resolve(options.path || '.');
   const githubPath = path.join(targetPath, '.github');
@@ -396,4 +425,4 @@ function mergeSettings(existing, newSettings) {
   return merged;
 }
 
-module.exports = { init, update, status };
+module.exports = { init, update, status, mcp };

package/mcp-manager.js

@@ -0,0 +1,163 @@
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+// Registry of known/safe MCP servers
+const MCP_Registry = {
+  'postgres': {
+    name: 'PostgreSQL MCP',
+    package: '@modelcontextprotocol/server-postgres',
+    config: {
+      command: 'npx',
+      args: ['-y', '@modelcontextprotocol/server-postgres', 'postgresql://localhost/mydb']
+    }
+  },
+  'filesystem': {
+    name: 'Filesystem MCP',
+    package: '@modelcontextprotocol/server-filesystem',
+    config: {
+      command: 'npx',
+      args: ['-y', '@modelcontextprotocol/server-filesystem', '.']
+    }
+  },
+  'github': {
+    name: 'GitHub MCP',
+    package: '@modelcontextprotocol/server-github',
+    config: {
+      command: 'npx',
+      args: ['-y', '@modelcontextprotocol/server-github'],
+      env: {
+        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
+      }
+    }
+  },
+  'sqlite': {
+    name: 'SQLite MCP',
+    package: '@modelcontextprotocol/server-sqlite',
+    config: {
+      command: 'npx',
+      args: ['-y', '@modelcontextprotocol/server-sqlite', '--file', 'db.sqlite']
+    }
+  },
+  'playwright': {
+    name: 'Playwright MCP',
+    package: '@modelcontextprotocol/server-playwright',
+    config: {
+      command: 'npx',
+      args: ['-y', '@modelcontextprotocol/server-playwright']
+    }
+  }
+};
+
+class McpManager {
+  constructor(cwd = process.cwd()) {
+    this.cwd = cwd;
+    this.vscodeDir = path.join(cwd, '.vscode');
+    this.settingsFile = path.join(this.vscodeDir, 'settings.json');
+  }
+
+  ensureVscodeDir() {
+    if (!fs.existsSync(this.vscodeDir)) {
+      fs.mkdirSync(this.vscodeDir, { recursive: true });
+    }
+  }
+
+  getSettings() {
+    if (fs.existsSync(this.settingsFile)) {
+      try {
+        // Strip comments if any (simple regex, not perfect but usually sufficient for VS Code JSON)
+        const content = fs.readFileSync(this.settingsFile, 'utf8').replace(/\/\*[\s\S]*?\*\/|([^\\:]|^)\/\/.*$/gm, '$1');
+        return JSON.parse(content);
+      } catch (e) {
+        console.warn("Warning: Could not parse settings.json. Starting fresh.");
+        return {};
+      }
+    }
+    return {};
+  }
+
+  saveSettings(settings) {
+    this.ensureVscodeDir();
+    fs.writeFileSync(this.settingsFile, JSON.stringify(settings, null, 2));
+    console.log(`✅ Updated .vscode/settings.json`);
+  }
+
+  /**
+   * Installs an MCP server.
+   * @param {string} serverRef - Either a short name (postgres) or a full package name (@modelcontextprotocol/server-postgres)
+   * @param {string[]} extraArgs - Optional extra args for the server
+   */
+  install(serverRef, extraArgs = []) {
+    console.log(`🤖 Agent requesting MCP: ${serverRef}...`);
+
+    let serverConfig = null;
+    let packageName = serverRef;
+    let shortName = serverRef;
+
+    // 1. Check Registry for "Short Names" (Optimization/Convenience)
+    if (MCP_Registry[serverRef]) {
+      console.log(`✨ Identified known tool: ${MCP_Registry[serverRef].name}`);
+      serverConfig = { ...MCP_Registry[serverRef].config }; // clone
+      packageName = MCP_Registry[serverRef].package;
+    } else {
+      // 2. Dynamic Installation (The "Open Mode")
+      console.log(`🌍 Unknown tool name. Treating as direct NPM package: ${serverRef}`);
+      
+      // Basic Safety Check: Official Scope Preference
+      const isOfficial = serverRef.startsWith('@modelcontextprotocol/');
+      if (!isOfficial) {
+         console.warn(`⚠️  WARNING: You are installing a community package '${serverRef}'. Ensure it is safe.`);
+      }
+
+      // Construct default config for unknown package
+      // Assumption: standard MCP servers run as "npx -y <package> studio" or similar, 
+      // but usually just running the binary via npx is the entry point.
+      serverConfig = {
+        command: 'npx',
+        args: ['-y', serverRef, ...extraArgs]
+      };
+      
+      // Generate a clean key name from package (e.g. @modelcontextprotocol/server-postgres -> postgres)
+      const parts = serverRef.split('/');
+      shortName = parts[parts.length - 1].replace('server-', '');
+    }
+
+    // Merge extra args if provided (and not already merged for dynamic)
+    if (MCP_Registry[serverRef] && extraArgs.length > 0) {
+      serverConfig.args = [...serverConfig.args, ...extraArgs];
+    }
+
+    console.log(`📦 Configuration: ${serverConfig.command} ${serverConfig.args.join(' ')}`);
+
+    // Update VS Code Settings
+    const settings = this.getSettings();
+    
+    // Initialize mcpServers object if missing
+    if (!settings['github.copilot.advanced.mcpServers']) {
+      settings['github.copilot.advanced.mcpServers'] = {};
+    }
+
+    // Prevent overwriting if exists? Or Update? Agent implies intent, so Update.
+    settings['github.copilot.advanced.mcpServers'][shortName] = serverConfig;
+    
+    this.saveSettings(settings);
+
+    console.log(`✅ INSTALLED: ${shortName}`);
+    console.log(`💡 Copilot can now use this tool.`);
+    
+    return true;
+  }
+
+  list() {
+    console.log("\nSuggested MCP Servers (Shortcuts):");
+    console.log("==================================");
+    for (const [key, val] of Object.entries(MCP_Registry)) {
+      console.log(`- ${key}: ${val.name} (${val.package})`);
+    }
+    console.log("\n💡 You can also install ANY package by name:");
+    console.log("   $ copilot-kit mcp install @modelcontextprotocol/server-foobar");
+    console.log("\n");
+  }
+}
+
+module.exports = McpManager;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sk-labs/copilot-kit",
-  "version": "3.0.5",
+  "version": "3.0.6",
   "description": "CLI tool to install Custom Agents, Skills & Prompt Workflows for GitHub Copilot",
   "main": "index.js",
   "bin": {