expxagents 0.19.0 → 0.20.0

package/assets/mcps/_catalog.yaml

@@ -0,0 +1,17 @@
+catalog:
+  version: "1.0.0"
+  categories:
+    - name: development
+      mcps: [github, postgresql]
+    - name: communication
+      mcps: [slack]
+    - name: project-management
+      mcps: [linear]
+    - name: monitoring
+      mcps: [sentry]
+    - name: knowledge
+      mcps: [notion]
+    - name: design
+      mcps: [figma, pencil]
+    - name: infrastructure
+      mcps: [vercel]

package/assets/mcps/figma.mcp.yaml

@@ -0,0 +1,35 @@
+id: figma
+name: Figma
+description: Design files, components, and style inspection
+category: design
+icon: figma
+
+detection:
+  method: npm
+  npm:
+    package: "figma-developer-mcp"
+
+server:
+  command: npx
+  args: ["-y", "figma-developer-mcp"]
+  env:
+    FIGMA_ACCESS_TOKEN: "${FIGMA_ACCESS_TOKEN}"
+
+auth:
+  - key: FIGMA_ACCESS_TOKEN
+    label: "Figma Access Token"
+    hint: "Create at https://www.figma.com/developers/api#access-tokens"
+    required: true
+
+tools:
+  - name: get_file
+    description: Get a Figma file and its contents
+  - name: get_components
+    description: Get components from a Figma file
+  - name: get_styles
+    description: Get styles defined in a Figma file
+
+relevant_sectors:
+  - design
+  - product
+  - development

package/assets/mcps/github.mcp.yaml

@@ -0,0 +1,44 @@
+id: github
+name: GitHub
+description: PRs, issues, code review, releases
+category: development
+icon: github
+
+detection:
+  method: hybrid
+  cli:
+    command: gh
+    version_flag: --version
+    min_version: "2.0.0"
+  npm:
+    package: "@modelcontextprotocol/server-github"
+
+server:
+  command: npx
+  args: ["-y", "@modelcontextprotocol/server-github"]
+  env:
+    GITHUB_PERSONAL_ACCESS_TOKEN: "${GITHUB_PERSONAL_ACCESS_TOKEN}"
+
+auth:
+  - key: GITHUB_PERSONAL_ACCESS_TOKEN
+    label: "GitHub Personal Access Token"
+    hint: "Create at https://github.com/settings/tokens (scopes: repo, read:org)"
+    required: true
+    validate: "gh auth status"
+
+tools:
+  - name: create_pull_request
+    description: Create a new pull request
+  - name: list_issues
+    description: List repository issues
+  - name: create_issue
+    description: Create a new issue
+  - name: search_code
+    description: Search code across repositories
+  - name: get_file_contents
+    description: Get contents of a file
+
+relevant_sectors:
+  - development
+  - quality
+  - operations

package/assets/mcps/linear.mcp.yaml

@@ -0,0 +1,37 @@
+id: linear
+name: Linear
+description: Issue tracking, project management, and team workflows
+category: project-management
+icon: linear
+
+detection:
+  method: npm
+  npm:
+    package: "@larryhudson/linear-mcp-server"
+
+server:
+  command: npx
+  args: ["-y", "@larryhudson/linear-mcp-server"]
+  env:
+    LINEAR_API_KEY: "${LINEAR_API_KEY}"
+
+auth:
+  - key: LINEAR_API_KEY
+    label: "Linear API Key"
+    hint: "Create at https://linear.app/settings/api"
+    required: true
+
+tools:
+  - name: create_issue
+    description: Create a new issue
+  - name: list_issues
+    description: List project issues
+  - name: update_issue
+    description: Update an existing issue
+  - name: list_projects
+    description: List available projects
+
+relevant_sectors:
+  - product
+  - development
+  - operations

package/assets/mcps/notion.mcp.yaml

@@ -0,0 +1,37 @@
+id: notion
+name: Notion
+description: Knowledge base, documentation, and collaborative workspace
+category: knowledge
+icon: notion
+
+detection:
+  method: npm
+  npm:
+    package: "@notionhq/notion-mcp-server"
+
+server:
+  command: npx
+  args: ["-y", "@notionhq/notion-mcp-server"]
+  env:
+    NOTION_API_KEY: "${NOTION_API_KEY}"
+
+auth:
+  - key: NOTION_API_KEY
+    label: "Notion API Key"
+    hint: "Create at https://www.notion.so/my-integrations"
+    required: true
+
+tools:
+  - name: search
+    description: Search pages and databases
+  - name: get_page
+    description: Get the content of a page
+  - name: create_page
+    description: Create a new page
+  - name: update_page
+    description: Update an existing page
+
+relevant_sectors:
+  - knowledge
+  - product
+  - operations

package/assets/mcps/pencil.mcp.yaml

@@ -0,0 +1,32 @@
+id: pencil
+name: Pencil
+description: Visual design creation and editing in VS Code
+category: design
+icon: pencil
+
+detection:
+  method: extension
+  extension:
+    prefix: "highagency.pencildev-"
+    binary_dir: out
+    binary_resolve: platform
+
+server:
+  command: null
+  args: ["--app", "visual_studio_code"]
+  env: {}
+
+auth: []
+
+tools:
+  - name: batch_design
+    description: Create and modify visual designs
+  - name: batch_get
+    description: Read design nodes
+  - name: get_screenshot
+    description: Capture design screenshots
+
+relevant_sectors:
+  - design
+  - marketing
+  - product

package/assets/mcps/postgresql.mcp.yaml

@@ -0,0 +1,39 @@
+id: postgresql
+name: PostgreSQL
+description: SQL queries, schema inspection, and database management
+category: development
+icon: postgresql
+
+detection:
+  method: hybrid
+  cli:
+    command: psql
+    version_flag: --version
+  npm:
+    package: "@modelcontextprotocol/server-postgres"
+
+server:
+  command: npx
+  args: ["-y", "@modelcontextprotocol/server-postgres"]
+  env:
+    POSTGRESQL_URL: "${POSTGRESQL_URL}"
+
+auth:
+  - key: POSTGRESQL_URL
+    label: "PostgreSQL Connection URL"
+    hint: "Format: postgresql://user:password@host:5432/database"
+    required: true
+    validate: "psql -c 'SELECT 1'"
+
+tools:
+  - name: query
+    description: Execute a SQL query
+  - name: list_tables
+    description: List all tables in the database
+  - name: describe_table
+    description: Get the schema of a specific table
+
+relevant_sectors:
+  - development
+  - data
+  - operations

package/assets/mcps/sentry.mcp.yaml

@@ -0,0 +1,41 @@
+id: sentry
+name: Sentry
+description: Error tracking, performance monitoring, and issue management
+category: monitoring
+icon: sentry
+
+detection:
+  method: npm
+  npm:
+    package: "@sentry/mcp-server"
+
+server:
+  command: npx
+  args: ["-y", "@sentry/mcp-server"]
+  env:
+    SENTRY_AUTH_TOKEN: "${SENTRY_AUTH_TOKEN}"
+    SENTRY_ORG: "${SENTRY_ORG}"
+
+auth:
+  - key: SENTRY_AUTH_TOKEN
+    label: "Sentry Auth Token"
+    hint: "Create at https://sentry.io/settings/auth-tokens/"
+    required: true
+    validate: "sentry-cli info"
+  - key: SENTRY_ORG
+    label: "Sentry Organization Slug"
+    hint: "Your Sentry organization slug"
+    required: true
+
+tools:
+  - name: list_issues
+    description: List Sentry issues
+  - name: get_issue
+    description: Get details of a specific issue
+  - name: search_events
+    description: Search error events
+
+relevant_sectors:
+  - development
+  - quality
+  - infrastructure

package/assets/mcps/slack.mcp.yaml

@@ -0,0 +1,37 @@
+id: slack
+name: Slack
+description: Team messaging, channels, and notifications
+category: communication
+icon: slack
+
+detection:
+  method: npm
+  npm:
+    package: "@modelcontextprotocol/server-slack"
+
+server:
+  command: npx
+  args: ["-y", "@modelcontextprotocol/server-slack"]
+  env:
+    SLACK_BOT_TOKEN: "${SLACK_BOT_TOKEN}"
+
+auth:
+  - key: SLACK_BOT_TOKEN
+    label: "Slack Bot Token"
+    hint: "Create a Slack app at https://api.slack.com/apps"
+    required: true
+
+tools:
+  - name: send_message
+    description: Send a message to a channel
+  - name: list_channels
+    description: List available channels
+  - name: search_messages
+    description: Search messages across channels
+  - name: get_thread
+    description: Get messages in a thread
+
+relevant_sectors:
+  - communication
+  - operations
+  - customer-success

package/assets/mcps/vercel.mcp.yaml

@@ -0,0 +1,39 @@
+id: vercel
+name: Vercel
+description: Deployments, projects, and hosting management
+category: infrastructure
+icon: vercel
+
+detection:
+  method: hybrid
+  cli:
+    command: vercel
+    version_flag: --version
+  npm:
+    package: "mcp-handler"
+
+server:
+  command: npx
+  args: ["-y", "mcp-handler"]
+  env:
+    VERCEL_TOKEN: "${VERCEL_TOKEN}"
+
+auth:
+  - key: VERCEL_TOKEN
+    label: "Vercel Token"
+    hint: "Create at https://vercel.com/account/tokens"
+    required: true
+    validate: "vercel whoami"
+
+tools:
+  - name: list_deployments
+    description: List recent deployments
+  - name: get_deployment
+    description: Get details of a specific deployment
+  - name: list_projects
+    description: List all projects
+
+relevant_sectors:
+  - infrastructure
+  - development
+  - operations

package/dist/cli/src/commands/doctor.js

@@ -2,7 +2,6 @@ import fs from 'fs';
 import path from 'path';
 import { execSync } from 'child_process';
 import { getAssetsDir } from '../utils/config.js';
-import { detectPencilExtension } from '../pencil/detect.js';
 export async function doctorCommand() {
     const cwd = process.cwd();
     const checks = [];
@@ -22,15 +21,32 @@ export async function doctorCommand() {
     catch {
         checks.push({ name: 'Claude Code CLI', status: 'fail', message: 'Not found — install from https://claude.ai/code' });
     }
-    // Pencil extension (optional)
-    const pencilInfo = detectPencilExtension();
-    checks.push({
-        name: 'Pencil extension',
-        status: pencilInfo ? 'ok' : 'warn',
-        message: pencilInfo
-            ? `v${pencilInfo.version} (visual templates enabled)`
-            : 'not found (optional — install highagency.pencildev for visual templates)',
-    });
+    // MCP integrations check
+    const { getConfiguredMcpIds } = await import('../mcp/validate.js');
+    const { loadMcpDefinition } = await import('../mcp/catalog.js');
+    const { detectMcp } = await import('../mcp/detect.js');
+    const configured = getConfiguredMcpIds(process.cwd());
+    const mcpsDir = path.resolve('mcps');
+    if (configured.length > 0) {
+        for (const id of configured) {
+            const def = loadMcpDefinition(mcpsDir, id);
+            if (def) {
+                const result = detectMcp(def);
+                checks.push({
+                    name: `MCP: ${def.name}`,
+                    status: result.status !== 'unavailable' ? 'ok' : 'warn',
+                    message: result.detail,
+                });
+            }
+        }
+    }
+    else {
+        checks.push({
+            name: 'MCP integrations',
+            status: 'warn',
+            message: 'No MCPs configured. Run: expxagents mcp setup <id>',
+        });
+    }
     // Project structure
     const requiredDirs = ['squads', '_expxagents/_memory'];
     for (const dir of requiredDirs) {

package/dist/cli/src/commands/init.js

@@ -3,7 +3,6 @@ import path from 'path';
 import crypto from 'crypto';
 import { execSync } from 'child_process';
 import { getTemplateDir, getAssetsDir } from '../utils/config.js';
-import { detectPencilExtension, resolvePlatformBinary, buildMcpConfig } from '../pencil/detect.js';
 function getDefaultTemplate(file) {
     if (file === 'company.md') {
         return `<!-- NOT CONFIGURED -->
@@ -331,6 +330,12 @@ export async function initCommand(options = {}) {
     else {
         console.log('  agents/ already exists (use --update to refresh)');
     }
+    // Copy MCP catalog
+    const mcpsSrc = path.join(assetsDir, 'mcps');
+    if (fs.existsSync(mcpsSrc)) {
+        const mcpsResult = copyDirRecursive(mcpsSrc, path.resolve('mcps'));
+        console.log(`  📡 MCP catalog: ${mcpsResult.changed}/${mcpsResult.total} files`);
+    }
     // Create/update Claude Code skill (.claude/skills/expxagents/SKILL.md)
     const skillDir = path.join(cwd, '.claude', 'skills', 'expxagents');
     const skillPath = path.join(skillDir, 'SKILL.md');
@@ -403,22 +408,37 @@ BRIDGE_TIMEOUT_MS=300000
         fs.writeFileSync(gitignorePath, gitignoreEntries.join('\n') + '\n', 'utf-8');
         console.log('  Created .gitignore');
     }
-    // Generate .mcp.json for Pencil MCP (if Pencil extension is installed)
-    const mcpJsonPath = path.join(cwd, '.mcp.json');
-    if (!fs.existsSync(mcpJsonPath)) {
-        const pencilInfo = detectPencilExtension();
-        if (pencilInfo) {
-            const binaryName = resolvePlatformBinary();
-            const mcpConfig = buildMcpConfig(pencilInfo, binaryName);
-            fs.writeFileSync(mcpJsonPath, JSON.stringify(mcpConfig, null, 2) + '\n', 'utf-8');
-            console.log(`  Created .mcp.json (Pencil ${pencilInfo.version} detected)`);
+    // MCP Setup
+    const mcpsDir = path.resolve('mcps');
+    if (fs.existsSync(mcpsDir)) {
+        const { listAllMcpIds, loadMcpDefinition } = await import('../mcp/catalog.js');
+        const { detectMcp, detectExtension, resolvePlatformBinary } = await import('../mcp/detect.js');
+        const { writeMcpConfig } = await import('../mcp/setup.js');
+        const ids = listAllMcpIds(mcpsDir);
+        const results = ids.map(id => {
+            const def = loadMcpDefinition(mcpsDir, id);
+            return def ? { def, detection: detectMcp(def) } : null;
+        }).filter((r) => r !== null);
+        console.log('\n🔍 Detecting available MCP integrations...\n');
+        for (const { def, detection } of results) {
+            const icon = detection.status === 'detected' ? '✅' : detection.status === 'available' ? '⬜' : '⛔';
+            console.log(`  ${icon} ${def.id.padEnd(14)} — ${detection.detail}`);
         }
-        else {
-            console.log('  Pencil extension not found — skipping .mcp.json (install highagency.pencildev for visual templates)');
+        // Auto-configure extension-based MCPs (like Pencil) that need no auth
+        for (const { def, detection } of results) {
+            if (detection.status === 'detected' && def.detection.method === 'extension' && def.auth.length === 0) {
+                if (def.detection.extension) {
+                    const ext = detectExtension(def.detection.extension.prefix);
+                    if (ext) {
+                        const binary = resolvePlatformBinary();
+                        const resolvedCmd = path.join(ext.extensionPath, def.detection.extension.binary_dir, binary);
+                        writeMcpConfig(process.cwd(), def, {}, resolvedCmd);
+                        console.log(`  → ${def.name} auto-configured`);
+                    }
+                }
+            }
         }
-    }
-    else {
-        console.log('  .mcp.json already exists');
+        console.log('\n  Run: expxagents mcp setup <id> to configure additional MCPs\n');
     }
     // Install Python dependencies
     const pythonDeps = ['aiohttp', 'aiofiles', 'python-dotenv'];

package/dist/cli/src/commands/mcp.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function mcpCommand(): Command;

package/dist/cli/src/commands/mcp.js

@@ -0,0 +1,155 @@
+import { Command } from 'commander';
+import fs from 'fs';
+import path from 'path';
+import yaml from 'js-yaml';
+import { loadMcpDefinition, listAllMcpIds } from '../mcp/catalog.js';
+import { detectMcp, detectExtension, resolvePlatformBinary } from '../mcp/detect.js';
+import { writeMcpConfig, removeMcpConfig } from '../mcp/setup.js';
+import { getConfiguredMcpIds } from '../mcp/validate.js';
+import { getAssetsDir } from '../utils/config.js';
+function getMcpsDir() {
+    const local = path.resolve('mcps');
+    if (fs.existsSync(local))
+        return local;
+    return path.join(getAssetsDir(), 'mcps');
+}
+export function mcpCommand() {
+    const mcp = new Command('mcp')
+        .description('Manage MCP integrations');
+    mcp
+        .command('list')
+        .description('List all MCPs: configured, available, unavailable')
+        .action(() => {
+        const mcpsDir = getMcpsDir();
+        const ids = listAllMcpIds(mcpsDir);
+        const configured = getConfiguredMcpIds(process.cwd());
+        const results = [];
+        for (const id of ids) {
+            const def = loadMcpDefinition(mcpsDir, id);
+            if (def)
+                results.push(detectMcp(def));
+        }
+        console.log('\nMCP Integrations:\n');
+        const configuredResults = results.filter(r => configured.includes(r.id));
+        if (configuredResults.length > 0) {
+            console.log('  CONFIGURED');
+            for (const r of configuredResults) {
+                console.log(`  \u2705 ${r.id.padEnd(14)} \u2014 ${r.detail}`);
+            }
+            console.log('');
+        }
+        const available = results.filter(r => !configured.includes(r.id) && r.status !== 'unavailable');
+        if (available.length > 0) {
+            console.log('  AVAILABLE');
+            for (const r of available) {
+                console.log(`  \u2b1c ${r.id.padEnd(14)} \u2014 ${r.detail}`);
+            }
+            console.log('');
+        }
+        const unavailable = results.filter(r => r.status === 'unavailable' && !configured.includes(r.id));
+        if (unavailable.length > 0) {
+            console.log('  UNAVAILABLE');
+            for (const r of unavailable) {
+                console.log(`  \u26d4 ${r.id.padEnd(14)} \u2014 ${r.detail}`);
+            }
+            console.log('');
+        }
+        console.log('Run: expxagents mcp setup <id> to configure\n');
+    });
+    mcp
+        .command('setup <ids...>')
+        .description('Configure one or more MCPs')
+        .action(async (ids) => {
+        const mcpsDir = getMcpsDir();
+        const readline = await import('readline');
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        const ask = (q) => new Promise(r => rl.question(q, r));
+        for (const id of ids) {
+            const def = loadMcpDefinition(mcpsDir, id);
+            if (!def) {
+                console.log(`\u274c Unknown MCP: ${id}`);
+                continue;
+            }
+            console.log(`\n\ud83d\udce6 Setting up ${def.name} MCP...\n`);
+            let resolvedCommand;
+            if (def.detection.method === 'extension' && def.detection.extension) {
+                const ext = detectExtension(def.detection.extension.prefix);
+                if (!ext) {
+                    console.log(`\u274c ${def.name} VSCode extension not found`);
+                    continue;
+                }
+                const binary = resolvePlatformBinary();
+                resolvedCommand = path.join(ext.extensionPath, def.detection.extension.binary_dir, binary);
+            }
+            const authValues = {};
+            for (const auth of def.auth) {
+                console.log(`  ${auth.hint}`);
+                const value = await ask(`? ${auth.label}: `);
+                authValues[auth.key] = value.trim();
+            }
+            writeMcpConfig(process.cwd(), def, authValues, resolvedCommand);
+            console.log(`\n\u2705 ${def.name} MCP configured\n`);
+        }
+        rl.close();
+    });
+    mcp
+        .command('remove <id>')
+        .description('Remove an MCP from .mcp.json and .env')
+        .option('-f, --force', 'Skip squad dependency check')
+        .action((id, options) => {
+        const configured = getConfiguredMcpIds(process.cwd());
+        if (!configured.includes(id)) {
+            console.log(`\u274c MCP "${id}" is not configured`);
+            return;
+        }
+        if (!options.force) {
+            const squadsDir = path.resolve('squads');
+            if (fs.existsSync(squadsDir)) {
+                const dependentSquads = [];
+                for (const entry of fs.readdirSync(squadsDir)) {
+                    const yamlPath = path.join(squadsDir, entry, 'squad.yaml');
+                    if (!fs.existsSync(yamlPath))
+                        continue;
+                    try {
+                        const raw = yaml.load(fs.readFileSync(yamlPath, 'utf-8'));
+                        const mcps = raw.squad?.mcps;
+                        if (mcps?.includes(id))
+                            dependentSquads.push(entry);
+                    }
+                    catch { /* skip */ }
+                }
+                if (dependentSquads.length > 0) {
+                    console.log(`\u26a0\ufe0f  Squads that depend on "${id}": ${dependentSquads.join(', ')}`);
+                    console.log(`   Use --force to remove anyway`);
+                    return;
+                }
+            }
+        }
+        removeMcpConfig(process.cwd(), id);
+        console.log(`\u2705 Removed MCP: ${id}`);
+    });
+    mcp
+        .command('check [id]')
+        .description('Validate configured MCP connections')
+        .action((id) => {
+        const configured = getConfiguredMcpIds(process.cwd());
+        const toCheck = id ? [id] : configured;
+        let issues = 0;
+        console.log('\nChecking MCP connections...\n');
+        for (const mcpId of toCheck) {
+            if (!configured.includes(mcpId)) {
+                console.log(`  \u274c ${mcpId.padEnd(14)} \u2014 Not configured`);
+                issues++;
+                continue;
+            }
+            console.log(`  \u2705 ${mcpId.padEnd(14)} \u2014 Configured`);
+        }
+        if (issues > 0) {
+            console.log(`\n${issues} issue(s) found.\n`);
+        }
+        else {
+            console.log(`\nAll MCPs OK.\n`);
+        }
+    });
+    return mcp;
+}

package/dist/cli/src/index.js

@@ -15,6 +15,7 @@ import { jarvisCommand } from './commands/jarvis.js';
 import { schedulerCommand } from './commands/scheduler.js';
 import { reorganizeCommand } from './commands/reorganize.js';
 import { syncTemplatesCommand } from './commands/sync-templates.js';
+import { mcpCommand } from './commands/mcp.js';
 import { ingestCommand } from './commands/ingest.js';
 import { knowledgeCommand } from './commands/knowledge.js';
 import { loginCommand } from './commands/login.js';
@@ -99,6 +100,7 @@ program
     .description('Open Jarvis voice assistant in browser')
     .action(jarvisCommand);
 program.addCommand(schedulerCommand());
+program.addCommand(mcpCommand());
 program
     .command('ingest <path>')
     .description('Ingest documents into the knowledge base')

package/dist/cli/src/mcp/__tests__/catalog.test.d.ts

@@ -0,0 +1 @@
+export {};