@comfanion/workflow 4.36.27 → 4.36.29

package/README.md

@@ -278,6 +278,31 @@ vectorizer:
 4. Remove TODOs
 ```
 
+## MCP Servers
+
+Extend AI capabilities with Model Context Protocol servers:
+
+```bash
+# List available MCP servers
+npx @comfanion/workflow mcp list
+
+# Enable servers interactively
+npx @comfanion/workflow mcp enable
+```
+
+### Recommended MCP Servers
+
+| Server | Description |
+|--------|-------------|
+| **context7** ⭐ | Library docs for npm, Go, Python |
+| **sequential-thinking** ⭐ | Enhanced reasoning for complex tasks |
+| **playwright** | Browser automation, testing |
+| **atlassian** | Jira/Confluence integration |
+
+MCP configs stored in `.opencode/mcp/`:
+- `catalog.yaml` - Available servers (updated by workflow)
+- `enabled.yaml` - Your selections (not touched by updates)
+
 ## Jira Integration
 
 Set credentials:

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:',
+          choices: [
+            { name: 'context7 - Library docs for npm, Go, Python (recommended)', value: 'context7', checked: true },
+            { name: 'sequential-thinking - Enhanced reasoning for complex tasks', value: 'sequential-thinking', checked: false },
+            { name: 'playwright - Browser automation and testing', value: 'playwright', checked: false },
+            { name: 'chrome-devtools - Chrome debugging and inspection', value: 'chrome-devtools', checked: false },
+            { name: 'atlassian - Jira/Confluence integration', value: 'atlassian', checked: false },
+            { name: 'github - GitHub repos, issues, PRs', value: 'github', 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,28 @@ program
           await fs.copy(changelogTemplate, changelogPath);
         }
       }
+      
+      // Save MCP server selections (only if user made selections)
+      if (config.mcp_servers && config.mcp_servers.length > 0) {
+        spinner.text = 'Configuring MCP servers...';
+        const mcpEnabledPath = path.join(targetDir, 'mcp', 'enabled.yaml');
+        
+        // Don't overwrite existing enabled.yaml if updating
+        if (!isUpdate || !await fs.pathExists(mcpEnabledPath)) {
+          let mcpContent = `# Enabled MCP Servers
+# Your personal selection of MCP servers
+# This file is NOT modified by updates
+
+`;
+          for (const server of config.mcp_servers) {
+            mcpContent += `${server}:
+  enabled: true
+
+`;
+          }
+          await fs.writeFile(mcpEnabledPath, mcpContent);
+        }
+      }
 
       // Install plugin dependencies
       spinner.text = 'Installing plugin dependencies...';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comfanion/workflow",
-  "version": "4.36.27",
+  "version": "4.36.29",
   "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.27",
-  "buildDate": "2026-01-24T20:40:40.663Z",
+  "version": "4.36.29",
+  "buildDate": "2026-01-24T20:54:34.023Z",
   "files": [
     "config.yaml",
     "FLOW.yaml",
@@ -11,6 +11,7 @@
     "commands",
     "tools",
     "plugins",
+    "mcp",
     "package.json",
     "opencode.json"
   ]

package/src/opencode/mcp/README.md

@@ -0,0 +1,89 @@
+# MCP Servers
+
+Model Context Protocol (MCP) servers extend AI assistant capabilities with external tools and integrations.
+
+## Quick Start
+
+```bash
+# List available MCP servers
+npx @comfanion/workflow mcp list
+
+# Interactive selection
+npx @comfanion/workflow mcp enable
+
+# Add specific server
+npx @comfanion/workflow mcp add context7
+
+# Remove server
+npx @comfanion/workflow mcp remove context7
+```
+
+## Files
+
+| File | Purpose | Updated by |
+|------|---------|------------|
+| `catalog.yaml` | Available MCP servers | `workflow update` |
+| `enabled.yaml` | Your selections | You (manual or CLI) |
+
+## Recommended Servers
+
+### context7 ⭐
+Library documentation for npm, Go, Python packages. Essential for researching APIs.
+
+### sequential-thinking ⭐
+Enhanced reasoning for complex multi-step problems. Helps with architecture decisions.
+
+## Categories
+
+- 📚 **Documentation** - Library docs, research
+- 🧠 **Thinking** - Reasoning, planning
+- 🌐 **Browser** - Playwright, Chrome DevTools
+- 🔌 **Integrations** - Jira, GitHub, Slack
+- 🗄️ **Database** - PostgreSQL, Redis, SQLite
+- 🔗 **API** - HTTP, OpenAPI
+
+## Manual Configuration
+
+Edit `enabled.yaml`:
+
+```yaml
+context7:
+  enabled: true
+
+atlassian:
+  enabled: true
+  config:
+    env:
+      ATLASSIAN_URL: "https://your-domain.atlassian.net"
+```
+
+## Environment Variables
+
+Some MCP servers require environment variables:
+
+```bash
+# Atlassian
+export ATLASSIAN_EMAIL="your-email@company.com"
+export ATLASSIAN_API_TOKEN="your-token"
+export ATLASSIAN_URL="https://your-domain.atlassian.net"
+
+# GitHub
+export GITHUB_TOKEN="ghp_xxx"
+
+# PostgreSQL
+export POSTGRES_CONNECTION_STRING="postgresql://..."
+```
+
+## Adding Custom MCP
+
+Add to `enabled.yaml`:
+
+```yaml
+my-custom-mcp:
+  enabled: true
+  config:
+    command: npx
+    args: ["-y", "my-custom-mcp-package"]
+    env:
+      MY_API_KEY: "xxx"
+```

package/src/opencode/mcp/catalog.yaml

@@ -0,0 +1,230 @@
+# MCP Server Catalog
+# Curated list of recommended MCP servers for AI-assisted development
+# 
+# This file is updated by `npx @comfanion/workflow update`
+# Your selections are stored in `enabled.yaml` (not touched by updates)
+#
+# 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
+#
+# Version: 1.0.0
+# Last updated: 2026-01-24
+
+servers:
+  # ==========================================================================
+  # DOCUMENTATION & RESEARCH
+  # ==========================================================================
+  
+  context7:
+    name: "Context7"
+    description: "Library documentation for npm, Go, Python packages"
+    category: documentation
+    recommended: true
+    config:
+      command: npx
+      args: ["-y", "@anthropic/mcp-context7"]
+    tags: [docs, npm, go, python, research]
+    
+  # ==========================================================================
+  # THINKING & REASONING
+  # ==========================================================================
+    
+  sequential-thinking:
+    name: "Sequential Thinking"
+    description: "Enhanced reasoning for complex multi-step problems"
+    category: thinking
+    recommended: true
+    config:
+      command: npx
+      args: ["-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"]
+    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"]
+    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
+    requires_env:
+      - GITHUB_TOKEN
+    config:
+      command: npx
+      args: ["-y", "@anthropic/mcp-github"]
+    tags: [github, git, issues, prs]
+    
+  gitlab:
+    name: "GitLab"
+    description: "GitLab repos, issues, MRs, pipelines"
+    category: integrations
+    recommended: false
+    requires_env:
+      - GITLAB_TOKEN
+    config:
+      command: npx
+      args: ["-y", "@anthropic/mcp-gitlab"]
+    tags: [gitlab, git, issues, mrs]
+
+  slack:
+    name: "Slack"
+    description: "Slack messages, channels, search"
+    category: integrations
+    recommended: false
+    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
+    requires_env:
+      - POSTGRES_CONNECTION_STRING
+    config:
+      command: npx
+      args: ["-y", "@anthropic/mcp-postgres"]
+    tags: [database, sql, postgres]
+    
+  sqlite:
+    name: "SQLite"
+    description: "Query SQLite databases"
+    category: database
+    recommended: false
+    config:
+      command: npx
+      args: ["-y", "@anthropic/mcp-sqlite"]
+    tags: [database, sql, sqlite]
+
+  redis:
+    name: "Redis"
+    description: "Redis key-value operations"
+    category: database
+    recommended: false
+    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"]
+    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"]
+    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:
+    name: "Documentation & Research"
+    icon: "📚"
+  thinking:
+    name: "Thinking & Reasoning"
+    icon: "🧠"
+  browser:
+    name: "Browser & UI"
+    icon: "🌐"
+  integrations:
+    name: "Integrations"
+    icon: "🔌"
+  database:
+    name: "Data & Storage"
+    icon: "🗄️"
+  system:
+    name: "File & System"
+    icon: "📁"
+  api:
+    name: "API & Web"
+    icon: "🔗"