@comfanion/workflow 4.36.28 → 4.36.30

package/bin/cli.js

@@ -255,10 +255,25 @@ program
           message: 'Enable auto-indexing? (reindex files on save)',
           when: (answers) => answers.install_vectorizer,
           default: true
+        },
+        {
+          type: 'checkbox',
+          name: 'mcp_servers',
+          message: 'Select MCP servers to enable (writes to opencode.json):',
+          choices: [
+            { name: 'context7 - Library docs for npm, Go, Python (recommended)', value: 'context7', checked: true },
+            { name: 'grep - Search code examples from GitHub', value: 'grep', checked: false },
+            { name: 'sequential-thinking - Enhanced reasoning for complex tasks', value: 'sequential-thinking', checked: false },
+            { name: 'playwright - Browser automation and testing', value: 'playwright', checked: false },
+            { name: 'github - GitHub repos, issues, PRs (needs GITHUB_TOKEN)', value: 'github', checked: false },
+            { name: 'sentry - Query Sentry issues and errors (OAuth)', value: 'sentry', checked: false },
+            { name: 'postgres - PostgreSQL database queries', value: 'postgres', checked: false }
+          ]
         }
       ]);
       
       config = { ...config, ...answers };
+      config.mcp_servers = answers.mcp_servers || [];
     } else {
       // Apply CLI flags for non-interactive mode
       if (options.tdd) config.methodology = 'tdd';
@@ -488,6 +503,42 @@ program
           await fs.copy(changelogTemplate, changelogPath);
         }
       }
+      
+      // Save MCP server selections to opencode.json
+      if (config.mcp_servers && config.mcp_servers.length > 0) {
+        spinner.text = 'Configuring MCP servers in opencode.json...';
+        const opencodeJsonPath = path.join(process.cwd(), 'opencode.json');
+        
+        // MCP catalog with server configs
+        const mcpCatalog = {
+          'context7': { type: 'remote', url: 'https://mcp.context7.com/mcp' },
+          'grep': { type: 'remote', url: 'https://mcp.grep.app' },
+          'sentry': { type: 'remote', url: 'https://mcp.sentry.dev/mcp', oauth: {} },
+          'sequential-thinking': { type: 'local', command: ['npx', '-y', '@anthropic/mcp-sequential-thinking'] },
+          'playwright': { type: 'local', command: ['npx', '-y', '@anthropic/mcp-playwright'] },
+          'github': { type: 'local', command: ['npx', '-y', '@anthropic/mcp-github'] },
+          'postgres': { type: 'local', command: ['npx', '-y', '@anthropic/mcp-postgres'] }
+        };
+        
+        // Read existing opencode.json or create new
+        let opencodeConfig = { "$schema": "https://opencode.ai/config.json" };
+        try {
+          if (await fs.pathExists(opencodeJsonPath)) {
+            opencodeConfig = JSON.parse(await fs.readFile(opencodeJsonPath, 'utf8'));
+          }
+        } catch {}
+        
+        // Add MCP servers
+        if (!opencodeConfig.mcp) opencodeConfig.mcp = {};
+        for (const serverId of config.mcp_servers) {
+          if (mcpCatalog[serverId]) {
+            opencodeConfig.mcp[serverId] = { ...mcpCatalog[serverId], enabled: true };
+          }
+        }
+        
+        await fs.writeFile(opencodeJsonPath, JSON.stringify(opencodeConfig, null, 2) + '\n');
+        console.log(chalk.green(`✅ MCP servers added to opencode.json`));
+      }
 
       // Install plugin dependencies
       spinner.text = 'Installing plugin dependencies...';
@@ -1198,4 +1249,239 @@ program
     }
   });
 
+// =============================================================================
+// MCP COMMANDS
+// =============================================================================
+
+// MCP catalog with server configs
+const MCP_CATALOG = {
+  'context7': { 
+    name: 'Context7',
+    description: 'Library docs for npm, Go, Python',
+    type: 'remote', 
+    url: 'https://mcp.context7.com/mcp',
+    recommended: true
+  },
+  'grep': { 
+    name: 'Grep by Vercel',
+    description: 'Search code examples from GitHub',
+    type: 'remote', 
+    url: 'https://mcp.grep.app',
+    recommended: false
+  },
+  'sentry': { 
+    name: 'Sentry',
+    description: 'Query Sentry issues and errors',
+    type: 'remote', 
+    url: 'https://mcp.sentry.dev/mcp', 
+    oauth: {},
+    recommended: false
+  },
+  'sequential-thinking': { 
+    name: 'Sequential Thinking',
+    description: 'Enhanced reasoning for complex tasks',
+    type: 'local', 
+    command: ['npx', '-y', '@anthropic/mcp-sequential-thinking'],
+    recommended: true
+  },
+  'playwright': { 
+    name: 'Playwright',
+    description: 'Browser automation and testing',
+    type: 'local', 
+    command: ['npx', '-y', '@anthropic/mcp-playwright'],
+    recommended: false
+  },
+  'github': { 
+    name: 'GitHub',
+    description: 'GitHub repos, issues, PRs',
+    type: 'local', 
+    command: ['npx', '-y', '@anthropic/mcp-github'],
+    requires_env: ['GITHUB_TOKEN'],
+    recommended: false
+  },
+  'gitlab': { 
+    name: 'GitLab',
+    description: 'GitLab repos, issues, MRs',
+    type: 'local', 
+    command: ['npx', '-y', '@anthropic/mcp-gitlab'],
+    requires_env: ['GITLAB_TOKEN'],
+    recommended: false
+  },
+  'postgres': { 
+    name: 'PostgreSQL',
+    description: 'Query PostgreSQL databases',
+    type: 'local', 
+    command: ['npx', '-y', '@anthropic/mcp-postgres'],
+    requires_env: ['POSTGRES_CONNECTION_STRING'],
+    recommended: false
+  },
+  'slack': { 
+    name: 'Slack',
+    description: 'Slack messages and channels',
+    type: 'local', 
+    command: ['npx', '-y', '@anthropic/mcp-slack'],
+    requires_env: ['SLACK_TOKEN'],
+    recommended: false
+  }
+};
+
+program
+  .command('mcp')
+  .description('Manage MCP servers in opencode.json')
+  .argument('<action>', 'list | add <id> | remove <id> | install')
+  .argument('[server]', 'Server ID for add/remove')
+  .action(async (action, server) => {
+    const opencodeJsonPath = path.join(process.cwd(), 'opencode.json');
+    
+    if (action === 'list') {
+      console.log(chalk.blue.bold('\n🔌 Available MCP Servers\n'));
+      
+      // Show installed
+      let installed = {};
+      try {
+        if (await fs.pathExists(opencodeJsonPath)) {
+          const config = JSON.parse(await fs.readFile(opencodeJsonPath, 'utf8'));
+          installed = config.mcp || {};
+        }
+      } catch {}
+      
+      for (const [id, info] of Object.entries(MCP_CATALOG)) {
+        const isInstalled = installed[id];
+        const status = isInstalled ? chalk.green('✓') : chalk.gray('○');
+        const rec = info.recommended ? chalk.yellow(' ⭐') : '';
+        const type = info.type === 'remote' ? chalk.cyan('[remote]') : chalk.gray('[local]');
+        console.log(`  ${status} ${chalk.white(id)}${rec} ${type}`);
+        console.log(chalk.gray(`     ${info.description}`));
+        if (info.requires_env) {
+          console.log(chalk.yellow(`     Requires: ${info.requires_env.join(', ')}`));
+        }
+      }
+      
+      console.log(chalk.gray('\nUsage:'));
+      console.log(chalk.cyan('  npx @comfanion/workflow mcp add context7'));
+      console.log(chalk.cyan('  npx @comfanion/workflow mcp remove github'));
+      console.log('');
+      
+    } else if (action === 'add') {
+      if (!server) {
+        console.log(chalk.red('Usage: mcp add <server-id>'));
+        console.log(chalk.gray('Run `mcp list` to see available servers'));
+        process.exit(1);
+      }
+      
+      if (!MCP_CATALOG[server]) {
+        console.log(chalk.red(`Unknown server: ${server}`));
+        console.log(chalk.gray('Run `mcp list` to see available servers'));
+        process.exit(1);
+      }
+      
+      const spinner = ora(`Adding ${server}...`).start();
+      
+      // Read or create opencode.json
+      let config = { "$schema": "https://opencode.ai/config.json" };
+      try {
+        if (await fs.pathExists(opencodeJsonPath)) {
+          config = JSON.parse(await fs.readFile(opencodeJsonPath, 'utf8'));
+        }
+      } catch {}
+      
+      if (!config.mcp) config.mcp = {};
+      
+      const serverConfig = MCP_CATALOG[server];
+      config.mcp[server] = {
+        type: serverConfig.type,
+        ...(serverConfig.type === 'remote' 
+          ? { url: serverConfig.url, ...(serverConfig.oauth ? { oauth: serverConfig.oauth } : {}) }
+          : { command: serverConfig.command }),
+        enabled: true
+      };
+      
+      await fs.writeFile(opencodeJsonPath, JSON.stringify(config, null, 2) + '\n');
+      spinner.succeed(chalk.green(`Added ${server} to opencode.json`));
+      
+      if (serverConfig.requires_env) {
+        console.log(chalk.yellow(`\n⚠️  Set environment variables:`));
+        for (const env of serverConfig.requires_env) {
+          console.log(chalk.cyan(`   export ${env}="..."`));
+        }
+      }
+      if (serverConfig.oauth) {
+        console.log(chalk.yellow(`\n⚠️  OAuth required. Run:`));
+        console.log(chalk.cyan(`   opencode mcp auth ${server}`));
+      }
+      
+    } else if (action === 'remove') {
+      if (!server) {
+        console.log(chalk.red('Usage: mcp remove <server-id>'));
+        process.exit(1);
+      }
+      
+      if (!await fs.pathExists(opencodeJsonPath)) {
+        console.log(chalk.yellow('No opencode.json found'));
+        return;
+      }
+      
+      const spinner = ora(`Removing ${server}...`).start();
+      
+      const config = JSON.parse(await fs.readFile(opencodeJsonPath, 'utf8'));
+      if (config.mcp && config.mcp[server]) {
+        delete config.mcp[server];
+        await fs.writeFile(opencodeJsonPath, JSON.stringify(config, null, 2) + '\n');
+        spinner.succeed(chalk.green(`Removed ${server} from opencode.json`));
+      } else {
+        spinner.info(chalk.yellow(`${server} not found in opencode.json`));
+      }
+      
+    } else if (action === 'install') {
+      // Interactive selection
+      const installed = {};
+      try {
+        if (await fs.pathExists(opencodeJsonPath)) {
+          const config = JSON.parse(await fs.readFile(opencodeJsonPath, 'utf8'));
+          Object.assign(installed, config.mcp || {});
+        }
+      } catch {}
+      
+      const choices = Object.entries(MCP_CATALOG).map(([id, info]) => ({
+        name: `${id} - ${info.description}${info.recommended ? ' (recommended)' : ''}`,
+        value: id,
+        checked: installed[id] || info.recommended
+      }));
+      
+      const { servers } = await inquirer.prompt([{
+        type: 'checkbox',
+        name: 'servers',
+        message: 'Select MCP servers:',
+        choices
+      }]);
+      
+      // Read or create opencode.json
+      let config = { "$schema": "https://opencode.ai/config.json" };
+      try {
+        if (await fs.pathExists(opencodeJsonPath)) {
+          config = JSON.parse(await fs.readFile(opencodeJsonPath, 'utf8'));
+        }
+      } catch {}
+      
+      config.mcp = {};
+      for (const id of servers) {
+        const serverConfig = MCP_CATALOG[id];
+        config.mcp[id] = {
+          type: serverConfig.type,
+          ...(serverConfig.type === 'remote' 
+            ? { url: serverConfig.url, ...(serverConfig.oauth ? { oauth: serverConfig.oauth } : {}) }
+            : { command: serverConfig.command }),
+          enabled: true
+        };
+      }
+      
+      await fs.writeFile(opencodeJsonPath, JSON.stringify(config, null, 2) + '\n');
+      console.log(chalk.green(`\n✅ Updated opencode.json with ${servers.length} MCP servers`));
+      
+    } else {
+      console.log(chalk.red(`Unknown action: ${action}`));
+      console.log('Available: list, add <id>, remove <id>, install');
+    }
+  });
+
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comfanion/workflow",
-  "version": "4.36.28",
+  "version": "4.36.30",
   "description": "Initialize OpenCode Workflow system for AI-assisted development with semantic code search",
   "type": "module",
   "bin": {

package/src/build-info.json

@@ -1,6 +1,6 @@
 {
-  "version": "4.36.28",
-  "buildDate": "2026-01-24T20:51:16.620Z",
+  "version": "4.36.30",
+  "buildDate": "2026-01-24T20:58:37.569Z",
   "files": [
     "config.yaml",
     "FLOW.yaml",

package/src/opencode/mcp/catalog.yaml

@@ -6,15 +6,14 @@
 #
 # Usage:
 #   npx @comfanion/workflow mcp list      # Show available MCP servers
-#   npx @comfanion/workflow mcp enable    # Interactive selection
-#   npx @comfanion/workflow mcp add <id>  # Add specific MCP
+#   npx @comfanion/workflow mcp install   # Install selected to opencode.json
 #
-# Version: 1.0.0
+# Version: 1.1.0
 # Last updated: 2026-01-24
 
 servers:
   # ==========================================================================
-  # DOCUMENTATION & RESEARCH
+  # DOCUMENTATION & RESEARCH (Remote MCP)
   # ==========================================================================
   
   context7:
@@ -22,13 +21,35 @@ servers:
     description: "Library documentation for npm, Go, Python packages"
     category: documentation
     recommended: true
-    config:
-      command: npx
-      args: ["-y", "@anthropic/mcp-context7"]
+    type: remote
+    url: "https://mcp.context7.com/mcp"
     tags: [docs, npm, go, python, research]
     
+  grep:
+    name: "Grep by Vercel"
+    description: "Search code examples from GitHub"
+    category: documentation
+    recommended: false
+    type: remote
+    url: "https://mcp.grep.app"
+    tags: [github, code-search, examples]
+
+  # ==========================================================================
+  # INTEGRATIONS (Remote MCP with OAuth)
+  # ==========================================================================
+  
+  sentry:
+    name: "Sentry"
+    description: "Query Sentry issues, projects, and error data"
+    category: integrations
+    recommended: false
+    type: remote
+    url: "https://mcp.sentry.dev/mcp"
+    oauth: true
+    tags: [errors, monitoring, debugging]
+
   # ==========================================================================
-  # THINKING & REASONING
+  # LOCAL MCP SERVERS
   # ==========================================================================
     
   sequential-thinking:
@@ -36,73 +57,37 @@ servers:
     description: "Enhanced reasoning for complex multi-step problems"
     category: thinking
     recommended: true
-    config:
-      command: npx
-      args: ["-y", "@anthropic/mcp-sequential-thinking"]
+    type: local
+    command: ["npx", "-y", "@anthropic/mcp-sequential-thinking"]
     tags: [reasoning, planning, complex-tasks]
 
-  # ==========================================================================
-  # BROWSER & UI
-  # ==========================================================================
-    
   playwright:
     name: "Playwright"
     description: "Browser automation, testing, and web scraping"
     category: browser
     recommended: false
-    config:
-      command: npx
-      args: ["-y", "@anthropic/mcp-playwright"]
+    type: local
+    command: ["npx", "-y", "@anthropic/mcp-playwright"]
     tags: [browser, testing, automation, scraping]
     
-  chrome-devtools:
-    name: "Chrome DevTools"
-    description: "Chrome debugging, performance analysis, DOM inspection"
-    category: browser
-    recommended: false
-    config:
-      command: npx
-      args: ["-y", "chrome-devtools-mcp@latest"]
-    tags: [chrome, debugging, devtools]
-    
   puppeteer:
     name: "Puppeteer"
     description: "Headless Chrome automation"
     category: browser
     recommended: false
-    config:
-      command: npx
-      args: ["-y", "@anthropic/mcp-puppeteer"]
+    type: local
+    command: ["npx", "-y", "@anthropic/mcp-puppeteer"]
     tags: [chrome, headless, automation]
 
-  # ==========================================================================
-  # INTEGRATIONS
-  # ==========================================================================
-    
-  atlassian:
-    name: "Atlassian (Jira/Confluence)"
-    description: "Jira issues, Confluence pages integration"
-    category: integrations
-    recommended: false
-    requires_env:
-      - ATLASSIAN_EMAIL
-      - ATLASSIAN_API_TOKEN
-      - ATLASSIAN_URL
-    config:
-      command: npx
-      args: ["-y", "@anthropic/mcp-atlassian"]
-    tags: [jira, confluence, tickets, docs]
-    
   github:
     name: "GitHub"
     description: "GitHub repos, issues, PRs, actions"
     category: integrations
     recommended: false
+    type: local
+    command: ["npx", "-y", "@anthropic/mcp-github"]
     requires_env:
       - GITHUB_TOKEN
-    config:
-      command: npx
-      args: ["-y", "@anthropic/mcp-github"]
     tags: [github, git, issues, prs]
     
   gitlab:
@@ -110,11 +95,10 @@ servers:
     description: "GitLab repos, issues, MRs, pipelines"
     category: integrations
     recommended: false
+    type: local
+    command: ["npx", "-y", "@anthropic/mcp-gitlab"]
     requires_env:
       - GITLAB_TOKEN
-    config:
-      command: npx
-      args: ["-y", "@anthropic/mcp-gitlab"]
     tags: [gitlab, git, issues, mrs]
 
   slack:
@@ -122,27 +106,21 @@ servers:
     description: "Slack messages, channels, search"
     category: integrations
     recommended: false
+    type: local
+    command: ["npx", "-y", "@anthropic/mcp-slack"]
     requires_env:
       - SLACK_TOKEN
-    config:
-      command: npx
-      args: ["-y", "@anthropic/mcp-slack"]
     tags: [slack, messaging, communication]
 
-  # ==========================================================================
-  # DATA & STORAGE
-  # ==========================================================================
-    
   postgres:
     name: "PostgreSQL"
     description: "Query PostgreSQL databases"
     category: database
     recommended: false
+    type: local
+    command: ["npx", "-y", "@anthropic/mcp-postgres"]
     requires_env:
       - POSTGRES_CONNECTION_STRING
-    config:
-      command: npx
-      args: ["-y", "@anthropic/mcp-postgres"]
     tags: [database, sql, postgres]
     
   sqlite:
@@ -150,9 +128,8 @@ servers:
     description: "Query SQLite databases"
     category: database
     recommended: false
-    config:
-      command: npx
-      args: ["-y", "@anthropic/mcp-sqlite"]
+    type: local
+    command: ["npx", "-y", "@anthropic/mcp-sqlite"]
     tags: [database, sql, sqlite]
 
   redis:
@@ -160,51 +137,30 @@ servers:
     description: "Redis key-value operations"
     category: database
     recommended: false
+    type: local
+    command: ["npx", "-y", "@anthropic/mcp-redis"]
     requires_env:
       - REDIS_URL
-    config:
-      command: npx
-      args: ["-y", "@anthropic/mcp-redis"]
     tags: [database, cache, redis]
 
-  # ==========================================================================
-  # FILE & SYSTEM
-  # ==========================================================================
-    
   filesystem:
     name: "Filesystem"
     description: "Advanced file operations (usually built-in)"
     category: system
     recommended: false
-    config:
-      command: npx
-      args: ["-y", "@anthropic/mcp-filesystem"]
+    type: local
+    command: ["npx", "-y", "@anthropic/mcp-filesystem"]
     tags: [files, filesystem]
 
-  # ==========================================================================
-  # API & WEB
-  # ==========================================================================
-    
   fetch:
     name: "Fetch"
     description: "HTTP requests to external APIs (usually built-in)"
     category: api
     recommended: false
-    config:
-      command: npx
-      args: ["-y", "@anthropic/mcp-fetch"]
+    type: local
+    command: ["npx", "-y", "@anthropic/mcp-fetch"]
     tags: [http, api, fetch]
 
-  openapi:
-    name: "OpenAPI"
-    description: "Interact with APIs via OpenAPI specs"
-    category: api
-    recommended: false
-    config:
-      command: npx
-      args: ["-y", "@anthropic/mcp-openapi"]
-    tags: [api, openapi, swagger]
-
 # Categories for UI grouping
 categories:
   documentation: