matimo 0.1.0-alpha.11 → 0.1.0-alpha.12

package/README.md

@@ -46,7 +46,7 @@ const matimo = await MatimoInstance.init({
   autoDiscover: true,
 });
 
-const result = await matimo.execute('slack-send-message', {
+const result = await matimo.execute('slack_send_channel_message', {
   channel: '#general',
   text: 'Hello from Matimo!',
 });
@@ -59,13 +59,17 @@ See [Three Integration Patterns](#three-integration-patterns) and [examples/](./
 Matimo ships with built-in support for:
 
 - **Core Tools**: File I/O, Web fetch, Command execution, Code search
-- **Slack Integration**: Send messages, manage channels, read threads
-- **Gmail Integration**: Send/read email, manage threads
-- **GitHub Integration**: Issues, pull requests, releases
+- **MCP Server**: Expose all tools via stdio or Streamable HTTP to Claude Desktop, Cursor, Windsurf, and any MCP client (`npx matimo mcp`)
+- **Slack Integration**: Send messages, manage channels, reactions, threads, DMs
+- **Gmail Integration**: Send/read email, manage threads, drafts
+- **GitHub Integration**: Issues, pull requests, releases, code search
+- **Notion Integration**: Pages, databases, blocks, search
+- **HubSpot Tools**: Contacts, companies, deals, tickets
 - **Postgres Tools**: Query/modify data with safety checks
-- **HubSpot Tools**: Read/Write data to Hubspot CRM
-- **Auto-Discovery**: Automatic detection of @matimo/\* providers from npm
-- **Matimo CLI**: Tool discovery, installation, and management
+- **Twilio Tools**: Send SMS/MMS, manage messages
+- **Mailchimp Tools**: Audiences, subscribers, email campaigns
+- **Auto-Discovery**: Automatic detection of `@matimo/*` providers from npm
+- **Matimo CLI**: Tool discovery, setup wizard, MCP config generation
 - **OAuth2 Support**: Provider-agnostic authorization for Slack, Gmail, GitHub, etc.
 - **Framework Support**: Factory pattern, Decorator pattern, LangChain, CrewAI
 - **TypeScript SDK**: Full type safety and IDE support
@@ -98,7 +102,7 @@ const result = await matimo.execute('calculator', { operation: 'add', a: 5, b: 3
 ### 2️⃣ Decorator Pattern (Class-Based)
 
 ```typescript
-@tool('slack-send-message')
+@tool('slack_send_channel_message')
 async sendMessage(channel: string, text: string) { /* Auto-executed */ }
 ```
 
@@ -111,7 +115,22 @@ const tools = matimo.listTools().map(tool => ({
 }));
 ```
 
-See [SDK Usage Patterns](./docs/user-guide/SDK_PATTERNS.md) and [LangChain Integration](./docs/framework-integrations/LANGCHAIN.md) for details.
+### 4️⃣ MCP Server (Claude Desktop, Cursor, Windsurf, any MCP client)
+
+```bash
+# Expose all installed @matimo/* tools via MCP in one command
+npx matimo mcp
+
+# Run the setup wizard to get a ready-to-paste client config
+npx matimo mcp setup
+
+# HTTP mode for remote access / Docker
+npx matimo mcp --transport http --port 3000 --self-signed
+```
+
+See [MCP Docs](./docs/MCP.md) for the full reference.
+
+See [SDK Usage Patterns](./docs/user-guide/SDK_PATTERNS.md), [LangChain Integration](./docs/framework-integrations/LANGCHAIN.md), and [MCP Server](./docs/MCP.md) for details.
 
 ---
 
@@ -157,10 +176,9 @@ cd examples/tools && pnpm install && pnpm agent:factory
 
 ## Features **Coming Soon:**
 
-- More tool providers (Stripe, Twilio, Notion, etc.)
+- More tool providers (Stripe, Jira, Linear, etc.)
 - Python SDK
 - Custom Tool Marketplace
-- MCP Server support
 
 ---
 

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "matimo",
-  "version": "0.1.0-alpha.11",
+  "version": "0.1.0-alpha.12",
   "description": "Universal tool provider SDK: Framework-agnostic YAML-driven tool ecosystem for AI agents. Execute a library of pre-built tools (Slack, Gmail, GitHub, AWS, etc.) or define your own in YAML.",
   "main": "packages/core/dist/index.js",
   "types": "packages/core/dist/index.d.ts",
+  "bin": {
+    "matimo": "packages/cli/dist/bin.js"
+  },
   "type": "module",
   "packageManager": "pnpm@8.15.0",
   "private": false,
@@ -47,7 +50,6 @@
   "files": [
     "packages/core/dist",
     "packages/cli/dist",
-    "packages/cli/bin",
     "README.md",
     "LICENSE"
   ],
@@ -55,8 +57,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@matimo/cli": "0.1.0-alpha.11",
-    "@matimo/core": "0.1.0-alpha.11"
+    "@matimo/cli": "0.1.0-alpha.12",
+    "@matimo/core": "0.1.0-alpha.12"
   },
   "devDependencies": {
     "@commitlint/cli": "^20.3.1",

package/packages/cli/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/packages/cli/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/packages/cli/dist/bin.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+/**
+ * Matimo CLI entry point
+ *
+ * This is the npm bin target — compiled to dist/bin.js.
+ * All command routing (install, list, search, mcp, etc.) is handled by cli.ts.
+ *
+ * Uses tsx to register ESM hooks so extensionless imports in @matimo/core work
+ * correctly. This is required because @matimo/core compiles TypeScript with
+ * "moduleResolution": "bundler" which omits .js extensions in the output.
+ *
+ * Tool discovery works automatically via ToolLoader.getNodeModulesPath():
+ *   1. Walks up from process.cwd() to find node_modules/@matimo/*
+ *   2. Falls back to __dirname-based discovery (for Claude Desktop where cwd='/')
+ *
+ * Users run:
+ *   npx matimo mcp                         # stdio mode
+ *   npx matimo mcp --transport http        # http mode
+ *   npx matimo install slack gmail         # install providers
+ *   npx matimo list                        # list installed tools
+ */
+import { spawn } from 'child_process';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { createRequire } from 'module';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// Resolve tsx from this package's dependencies
+const require = createRequire(import.meta.url);
+let tsxBin;
+try {
+    const tsxPkgPath = require.resolve('tsx/package.json');
+    tsxBin = join(dirname(tsxPkgPath), 'dist', 'cli.mjs');
+}
+catch {
+    tsxBin = 'tsx';
+}
+const cliScript = join(__dirname, 'cli.js');
+const child = spawn(process.execPath, [tsxBin, cliScript, ...process.argv.slice(2)], {
+    stdio: 'inherit',
+    env: process.env,
+});
+child.on('error', (error) => {
+    console.error('❌ Failed to start Matimo CLI. Make sure tsx is installed.');
+    console.error('   Run: npm install tsx');
+    console.error('   Error:', error.message);
+    process.exit(1);
+});
+child.on('exit', (code) => process.exit(code || 0));
+//# sourceMappingURL=bin.js.map

package/packages/cli/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,+CAA+C;AAC/C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,IAAI,MAAc,CAAC;AACnB,IAAI,CAAC;IACH,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACvD,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;AACxD,CAAC;AAAC,MAAM,CAAC;IACP,MAAM,GAAG,KAAK,CAAC;AACjB,CAAC;AAED,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAC5C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;IACnF,KAAK,EAAE,SAAS;IAChB,GAAG,EAAE,OAAO,CAAC,GAAG;CACjB,CAAC,CAAC;AAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE;IACjC,OAAO,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC3E,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IACzC,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAmB,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC"}

package/packages/cli/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAgBA,wBAAgB,QAAQ,IAAI,IAAI,CAmC/B;AAED;;GAEG;AACH,wBAAsB,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAwC5D"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAiBA,wBAAgB,QAAQ,IAAI,IAAI,CA2D/B;AAED;;GAEG;AACH,wBAAsB,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA2C5D"}

package/packages/cli/dist/cli.js

@@ -1,8 +1,9 @@
 import { readFileSync } from 'fs';
-import { join } from 'path';
+import { join, basename } from 'path';
 import { installCommand } from './commands/install.js';
 import { listCommand } from './commands/list.js';
 import { searchCommand } from './commands/search.js';
+import { mcpCommand } from './commands/mcp.js';
 function getPackageVersion() {
     try {
         const pkgPath = join(process.cwd(), 'package.json');
@@ -29,10 +30,26 @@ Commands:
   search <query>        Search for available tools
                        Example: matimo search slack
   
+  mcp                   Start MCP server (Model Context Protocol)
+                       Example: matimo mcp
+                       Example: matimo mcp --transport http --port 3000
+  
+  mcp setup             Generate config for Claude Desktop / Cursor
+                       Example: matimo mcp setup
+  
   help                  Show this help message
   
   version               Show version information
 
+MCP Options:
+  --transport <type>    Transport mode: stdio (default) or http
+  --port <number>       HTTP port (default: 3000)
+  --tools <list>        Comma-separated tool allowlist
+  --exclude <list>      Comma-separated tool denylist
+  --secrets <list>      Secret resolvers: env,dotenv,vault,aws
+  --token <string>      Bearer token for HTTP mode
+  --env-file <path>     Path to .env file
+
 Examples:
   # Install new tools
   $ matimo install slack
@@ -43,7 +60,15 @@ Examples:
   
   # Search for tools
   $ matimo search email
-  $ matimo search database
+  
+  # Start MCP server for Claude Desktop
+  $ matimo mcp
+  
+  # Start MCP HTTP server with auth
+  $ MATIMO_MCP_TOKEN=secret matimo mcp --transport http
+  
+  # Generate Claude Desktop config
+  $ matimo mcp setup
 
 Documentation: https://github.com/tallclub/matimo#readme
 Issues: https://github.com/tallclub/matimo/issues
@@ -71,6 +96,9 @@ export async function main(cliArgs) {
             case 'search':
                 await searchCommand(params[0] || '');
                 break;
+            case 'mcp':
+                await mcpCommand(params);
+                break;
             case 'help':
             case '-h':
             case '--help':
@@ -92,4 +120,22 @@ export async function main(cliArgs) {
         process.exit(1);
     }
 }
+// Auto-execute when run directly (e.g., via tsx src/cli.ts or through bin.ts).
+// bin.ts spawns: node <tsx-cli.mjs> <cli.js> ...args
+// - When tsx shifts its own entry out of argv: process.argv[1] == cli.js
+// - When tsx does NOT shift argv:              process.argv[2] == cli.js
+// Checking both slots handles either tsx version. When imported as a module
+// (tests, bin.ts import) neither slot contains 'cli.js'.
+// Use basename() to normalise path separators (POSIX / and Windows \).
+/* istanbul ignore next */
+const toCliJs = (s) => basename(s).replace(/\.ts$/, '.js');
+/* istanbul ignore next */
+const isRunDirectly = toCliJs(process.argv[1] ?? '') === 'cli.js' || toCliJs(process.argv[2] ?? '') === 'cli.js';
+/* istanbul ignore next */
+if (isRunDirectly) {
+    main().catch((error) => {
+        console.error('❌ Fatal error:', error);
+        process.exit(1);
+    });
+}
 //# sourceMappingURL=cli.js.map

package/packages/cli/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,SAAS,iBAAiB;IACxB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;QACtD,OAAO,GAAG,CAAC,OAAO,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,OAAO,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCd,CAAC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,OAAkB;IAC3C,MAAM,IAAI,GAAG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAE7B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,QAAQ,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC;QACH,QAAQ,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;YAC9B,KAAK,SAAS;gBACZ,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;gBAC7B,MAAM;YACR,KAAK,MAAM;gBACT,MAAM,WAAW,EAAE,CAAC;gBACpB,MAAM;YACR,KAAK,QAAQ;gBACX,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;gBACrC,MAAM;YACR,KAAK,MAAM,CAAC;YACZ,KAAK,IAAI,CAAC;YACV,KAAK,QAAQ;gBACX,QAAQ,EAAE,CAAC;gBACX,MAAM;YACR,KAAK,SAAS,CAAC;YACf,KAAK,IAAI,CAAC;YACV,KAAK,WAAW;gBACd,OAAO,CAAC,IAAI,CAAC,eAAe,iBAAiB,EAAE,EAAE,CAAC,CAAC;gBACnD,MAAM;YACR;gBACE,OAAO,CAAC,KAAK,CAAC,sBAAsB,OAAO,EAAE,CAAC,CAAC;gBAC/C,OAAO,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;gBAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAClF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/packages/cli/dist/commands/mcp-setup.d.ts

@@ -0,0 +1,9 @@
+/**
+ * CLI command: matimo mcp setup
+ *
+ * Interactive config generator for MCP server.
+ * Detects installed tools, scans for required auth env vars,
+ * and outputs a ready-to-paste Claude Desktop / Cursor config.
+ */
+export declare function mcpSetupCommand(): Promise<void>;
+//# sourceMappingURL=mcp-setup.d.ts.map

package/packages/cli/dist/commands/mcp-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-setup.d.ts","sourceRoot":"","sources":["../../src/commands/mcp-setup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAiHrD"}

package/packages/cli/dist/commands/mcp-setup.js

@@ -0,0 +1,106 @@
+/**
+ * CLI command: matimo mcp setup
+ *
+ * Interactive config generator for MCP server.
+ * Detects installed tools, scans for required auth env vars,
+ * and outputs a ready-to-paste Claude Desktop / Cursor config.
+ */
+export async function mcpSetupCommand() {
+    console.info('\n🔨 Matimo MCP Setup\n');
+    console.info('Scanning for installed tool packages...\n');
+    try {
+        // @ts-ignore - dynamic import of package resolved at runtime
+        const { ToolLoader, extractAuthPlaceholders } = await import('@matimo/core');
+        const loader = new ToolLoader();
+        // Auto-discover installed packages
+        const toolPaths = loader.autoDiscoverPackages();
+        if (toolPaths.length === 0) {
+            console.info('No @matimo/* tool packages found.');
+            console.info('Install tools first: matimo install slack github\n');
+            return;
+        }
+        // Load all tools
+        const tools = loader.loadToolsFromMultiplePaths(toolPaths);
+        console.info(`Found ${tools.size} tools across ${toolPaths.length} package(s):\n`);
+        // Group tools by provider (extract from tool name prefix)
+        const providers = new Map();
+        const authVars = new Set();
+        for (const [name, tool] of tools) {
+            // Extract provider from tool name (e.g., "slack_send" → "slack")
+            const provider = name.includes('_')
+                ? name.split('_')[0]
+                : name.includes('-')
+                    ? name.split('-')[0]
+                    : 'core';
+            if (!providers.has(provider)) {
+                providers.set(provider, []);
+            }
+            providers.get(provider).push(name);
+            // Extract auth placeholders
+            const placeholders = extractAuthPlaceholders(tool);
+            for (const p of placeholders) {
+                authVars.add(p);
+            }
+        }
+        // Display providers and tools
+        for (const [provider, toolNames] of providers) {
+            console.info(`  📦 ${provider} (${toolNames.length} tools)`);
+            for (const name of toolNames.slice(0, 5)) {
+                console.info(`     • ${name}`);
+            }
+            if (toolNames.length > 5) {
+                console.info(`     ... and ${toolNames.length - 5} more`);
+            }
+        }
+        console.info('');
+        // Display required env vars
+        if (authVars.size > 0) {
+            console.info('🔐 Required environment variables:\n');
+            for (const v of authVars) {
+                const value = process.env[v] || process.env[`MATIMO_${v}`];
+                const status = value ? '✅' : '❌';
+                console.info(`  ${status} ${v}`);
+            }
+            console.info('');
+        }
+        // Generate Claude Desktop config
+        const envBlock = {};
+        for (const v of authVars) {
+            envBlock[v] = process.env[v] || process.env[`MATIMO_${v}`] || '<your-token>';
+        }
+        const claudeConfig = {
+            mcpServers: {
+                matimo: {
+                    command: 'npx',
+                    args: ['matimo', 'mcp'],
+                    env: envBlock,
+                },
+            },
+        };
+        console.info('📋 Claude Desktop config (paste into Settings → Developer → MCP Servers):\n');
+        console.info(JSON.stringify(claudeConfig, null, 2));
+        // Generate Cursor config
+        console.info('\n📋 Cursor config (paste into .cursor/mcp.json):\n');
+        const cursorConfig = {
+            mcpServers: {
+                matimo: {
+                    command: 'npx',
+                    args: ['matimo', 'mcp'],
+                    env: envBlock,
+                },
+            },
+        };
+        console.info(JSON.stringify(cursorConfig, null, 2));
+        // HTTP mode example
+        console.info('\n📋 HTTP mode (for remote hosting / Docker):\n');
+        const envExport = [...authVars].map((v) => `  ${v}=<your-token>`).join(' \\\n');
+        console.info(`  ${envExport} \\`);
+        console.info(`  MATIMO_MCP_TOKEN=<your-server-secret> \\`);
+        console.info(`  npx matimo mcp --transport http --port 3000\n`);
+    }
+    catch (error) {
+        console.error('❌ Setup failed:', error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=mcp-setup.js.map

package/packages/cli/dist/commands/mcp-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-setup.js","sourceRoot":"","sources":["../../src/commands/mcp-setup.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,16 @@
+/**
+ * CLI command: matimo mcp
+ *
+ * Starts the Matimo MCP server with configurable transport and options.
+ *
+ * Usage:
+ *   matimo mcp                                    # stdio mode (default)
+ *   matimo mcp --transport http --port 3000       # HTTP mode
+ *   matimo mcp --tools slack,github               # only these tools
+ *   matimo mcp --exclude postgres                 # exclude these tools
+ *   matimo mcp --secrets env,vault                # secret resolver chain
+ *   matimo mcp --token my-secret                  # HTTP bearer token
+ *   matimo mcp --tool-paths /path/to/tools       # custom tool paths
+ */
+export declare function mcpCommand(params: string[]): Promise<void>;
+//# sourceMappingURL=mcp.d.ts.map

package/packages/cli/dist/commands/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAsKH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA6FhE"}

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

@@ -0,0 +1,220 @@
+/**
+ * CLI command: matimo mcp
+ *
+ * Starts the Matimo MCP server with configurable transport and options.
+ *
+ * Usage:
+ *   matimo mcp                                    # stdio mode (default)
+ *   matimo mcp --transport http --port 3000       # HTTP mode
+ *   matimo mcp --tools slack,github               # only these tools
+ *   matimo mcp --exclude postgres                 # exclude these tools
+ *   matimo mcp --secrets env,vault                # secret resolver chain
+ *   matimo mcp --token my-secret                  # HTTP bearer token
+ *   matimo mcp --tool-paths /path/to/tools       # custom tool paths
+ */
+function parseArgs(params) {
+    const args = {
+        transport: 'stdio',
+        port: 3000,
+    };
+    /** Assert that a value-consuming flag was given an argument, not another flag or end-of-input. */
+    const requireValue = (flag, value) => {
+        if (!value || value.startsWith('-')) {
+            console.error(`❌ ${flag} requires a value`);
+            process.exit(1);
+        }
+        return value;
+    };
+    for (let i = 0; i < params.length; i++) {
+        const flag = params[i];
+        const next = params[i + 1];
+        switch (flag) {
+            case '--transport':
+            case '-t':
+                if (next === 'stdio' || next === 'http') {
+                    args.transport = next;
+                    i++;
+                }
+                else {
+                    console.error('❌ --transport must be "stdio" or "http"');
+                    process.exit(1);
+                }
+                break;
+            case '--port':
+            case '-p':
+                args.port = parseInt(next, 10);
+                if (isNaN(args.port)) {
+                    console.error('❌ --port must be a number');
+                    process.exit(1);
+                }
+                i++;
+                break;
+            case '--tools':
+                args.tools = requireValue('--tools', next)
+                    .split(',')
+                    .map((s) => s.trim());
+                i++;
+                break;
+            case '--exclude':
+                args.excludeTools = requireValue('--exclude', next)
+                    .split(',')
+                    .map((s) => s.trim());
+                i++;
+                break;
+            case '--secrets':
+                args.secrets = requireValue('--secrets', next)
+                    .split(',')
+                    .map((s) => s.trim());
+                i++;
+                break;
+            case '--env-file':
+                args.envFile = requireValue('--env-file', next);
+                i++;
+                break;
+            case '--vault-path':
+                args.vaultPath = requireValue('--vault-path', next);
+                i++;
+                break;
+            case '--aws-secret-id':
+                args.awsSecretId = requireValue('--aws-secret-id', next);
+                i++;
+                break;
+            case '--token':
+                args.token = requireValue('--token', next);
+                i++;
+                break;
+            case '--tool-paths':
+                args.toolPaths = requireValue('--tool-paths', next)
+                    .split(',')
+                    .map((s) => s.trim());
+                i++;
+                break;
+            case '--https':
+                args.https = true;
+                break;
+            case '--self-signed':
+                args.https = true;
+                args.selfSigned = true;
+                break;
+            case '--cert':
+                args.certPath = requireValue('--cert', next);
+                args.https = true;
+                i++;
+                break;
+            case '--key':
+                args.keyPath = requireValue('--key', next);
+                args.https = true;
+                i++;
+                break;
+            case 'setup':
+                // Handled separately in cli.ts
+                break;
+            default:
+                if (flag.startsWith('-')) {
+                    console.error(`❌ Unknown flag: ${flag}`);
+                    process.exit(1);
+                }
+        }
+    }
+    return args;
+}
+function buildResolverConfig(args) {
+    const secretTypes = args.secrets ?? ['env', 'dotenv'];
+    const resolvers = secretTypes.map((type) => {
+        switch (type) {
+            case 'env':
+                return { type: 'env' };
+            case 'dotenv':
+                return { type: 'dotenv', path: args.envFile };
+            case 'vault':
+                return { type: 'vault', secretPath: args.vaultPath };
+            case 'aws':
+                return { type: 'aws', secretId: args.awsSecretId };
+            default:
+                console.error(`❌ Unknown secret resolver: ${type}. Use: env, dotenv, vault, aws`);
+                process.exit(1);
+        }
+    });
+    return { resolvers };
+}
+export async function mcpCommand(params) {
+    // Check for 'setup' subcommand
+    if (params[0] === 'setup') {
+        const { mcpSetupCommand } = await import('./mcp-setup.js');
+        await mcpSetupCommand();
+        return;
+    }
+    const args = parseArgs(params);
+    // Lazy-import core MCP server
+    // @ts-ignore - dynamic import of package resolved at runtime
+    const { MCPServer } = await import('@matimo/core');
+    const server = new MCPServer({
+        transport: args.transport,
+        port: args.port,
+        tools: args.tools,
+        excludeTools: args.excludeTools,
+        secretResolver: buildResolverConfig(args),
+        mcpToken: args.token,
+        toolPaths: args.toolPaths,
+        autoDiscover: true,
+        https: args.https,
+        selfSigned: args.selfSigned,
+        certPath: args.certPath,
+        keyPath: args.keyPath,
+    });
+    // Graceful shutdown
+    const shutdown = async () => {
+        // Only log to stderr in stdio mode (stdout is JSON-RPC)
+        if (args.transport === 'stdio') {
+            process.stderr.write('\nShutting down Matimo MCP server...\n');
+        }
+        else {
+            console.info('\nShutting down Matimo MCP server...');
+        }
+        await server.stop();
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+    try {
+        await server.start();
+        if (args.transport === 'http') {
+            const protocol = args.https ? 'https' : 'http';
+            const url = `${protocol}://localhost:${args.port}/mcp`;
+            const token = server.getActiveToken();
+            console.info('');
+            console.info(`🚀 Matimo MCP server running at ${url}`);
+            if (args.https) {
+                if (args.selfSigned || (!args.certPath && !args.keyPath)) {
+                    console.info('🔒 HTTPS enabled (self-signed certificate)');
+                    console.info('   ⚠️  Clients may need to disable cert verification for self-signed certs');
+                }
+                else {
+                    console.info('🔒 HTTPS enabled');
+                }
+            }
+            if (token) {
+                const isAutoGenerated = !args.token && !process.env.MATIMO_MCP_TOKEN;
+                console.info('');
+                console.info(`🔐 Bearer Token${isAutoGenerated ? ' (auto-generated)' : ''}:`);
+                console.info(`   ${token}`);
+                console.info('');
+                console.info('   Connect your MCP client:');
+                console.info(`   url: ${url}`);
+                console.info(`   Authorization: Bearer ${token}`);
+                if (isAutoGenerated) {
+                    console.info('');
+                    console.info('   To use a fixed token, set MATIMO_MCP_TOKEN or use --token <value>');
+                }
+            }
+            console.info('');
+            console.info('   Press Ctrl+C to stop');
+            console.info('');
+        }
+    }
+    catch (error) {
+        console.error('❌ Failed to start MCP server:', error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=mcp.js.map