mcpmate 0.1.0

package/dist/commands/uninstall.js

@@ -0,0 +1,48 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uninstallServer = uninstallServer;
+const chalk_1 = __importDefault(require("chalk"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const CONFIG_DIR = path_1.default.join(os_1.default.homedir(), '.mcpm');
+const SERVERS_FILE = path_1.default.join(CONFIG_DIR, 'servers.json');
+async function getInstalledServers() {
+    if (await fs_extra_1.default.pathExists(SERVERS_FILE)) {
+        return await fs_extra_1.default.readJson(SERVERS_FILE);
+    }
+    return {};
+}
+async function saveInstalledServers(servers) {
+    await fs_extra_1.default.ensureDir(CONFIG_DIR);
+    await fs_extra_1.default.writeJson(SERVERS_FILE, servers, { spaces: 2 });
+}
+async function uninstallServer(serverName) {
+    console.log(chalk_1.default.blue('🗑️  Uninstalling MCP server...'));
+    console.log(chalk_1.default.gray(`Server: ${serverName}`));
+    console.log();
+    const servers = await getInstalledServers();
+    if (!servers[serverName]) {
+        console.log(chalk_1.default.yellow(`⚠️  Server "${serverName}" is not installed.`));
+        return;
+    }
+    const { confirm } = await inquirer_1.default.prompt([{
+            type: 'confirm',
+            name: 'confirm',
+            message: `Are you sure you want to uninstall "${serverName}"?`,
+            default: false
+        }]);
+    if (!confirm) {
+        console.log(chalk_1.default.gray('Uninstallation cancelled.'));
+        return;
+    }
+    delete servers[serverName];
+    await saveInstalledServers(servers);
+    console.log();
+    console.log(chalk_1.default.green('✅ Server uninstalled successfully!'));
+}
+//# sourceMappingURL=uninstall.js.map

package/dist/commands/uninstall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall.js","sourceRoot":"","sources":["../../src/commands/uninstall.ts"],"names":[],"mappings":";;;;;AAqBA,0CA6BC;AAlDD,kDAA0B;AAC1B,wDAA0B;AAC1B,gDAAwB;AACxB,4CAAoB;AACpB,wDAAgC;AAEhC,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,YAAE,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;AACpD,MAAM,YAAY,GAAG,cAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;AAE3D,KAAK,UAAU,mBAAmB;IAChC,IAAI,MAAM,kBAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACtC,OAAO,MAAM,kBAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAC,OAA4B;IAC9D,MAAM,kBAAE,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAC/B,MAAM,kBAAE,CAAC,SAAS,CAAC,YAAY,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;AAC3D,CAAC;AAEM,KAAK,UAAU,eAAe,CAAC,UAAkB;IACtD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC,CAAC;IAC3D,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,WAAW,UAAU,EAAE,CAAC,CAAC,CAAC;IACjD,OAAO,CAAC,GAAG,EAAE,CAAC;IAEd,MAAM,OAAO,GAAG,MAAM,mBAAmB,EAAE,CAAC;IAE5C,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,eAAe,UAAU,qBAAqB,CAAC,CAAC,CAAC;QAC1E,OAAO;IACT,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,kBAAQ,CAAC,MAAM,CAAC,CAAC;YACzC,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,uCAAuC,UAAU,IAAI;YAC9D,OAAO,EAAE,KAAK;SACf,CAAC,CAAC,CAAC;IAEJ,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC,CAAC;QACrD,OAAO;IACT,CAAC;IAED,OAAO,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3B,MAAM,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAEpC,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC,CAAC;AACjE,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "mcpmate",
+  "version": "0.1.0",
+  "description": "MCP Mate - The ultimate MCP server manager for OpenClaw and Chinese developers",
+  "main": "dist/index.js",
+  "bin": {
+    "mcpmate": "dist/cli.js",
+    "mcm": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/cli.ts",
+    "start": "node dist/cli.js",
+    "test": "jest"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "cli",
+    "server-manager",
+    "openclaw",
+    "feishu",
+    "dingtalk",
+    "china"
+  ],
+  "author": "Clawton",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/clawton/mcpmate.git"
+  },
+  "bugs": {
+    "url": "https://github.com/clawton/mcpmate/issues"
+  },
+  "homepage": "https://github.com/clawton/mcpmate#readme",
+  "dependencies": {
+    "commander": "^11.1.0",
+    "chalk": "^4.1.2",
+    "inquirer": "^8.2.6",
+    "axios": "^1.6.2",
+    "fs-extra": "^11.2.0",
+    "yaml": "^2.3.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.4",
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^9.0.7",
+    "typescript": "^5.3.3",
+    "ts-node": "^10.9.2",
+    "jest": "^29.7.0",
+    "@types/jest": "^29.5.11"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,191 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { searchServers } from './commands/search';
+import { installServer } from './commands/install';
+import { listServers } from './commands/list';
+import { uninstallServer } from './commands/uninstall';
+import { enableServer, disableServer } from './commands/toggle';
+import { exportConfig } from './commands/export';
+import { openclawCommand } from './commands/openclaw';
+import { templateCommand } from './commands/template';
+
+const program = new Command();
+
+program
+  .name('mcpmate')
+  .alias('mcm')
+  .description('MCP Mate - The ultimate MCP server manager for OpenClaw and Chinese developers')
+  .version('0.1.0');
+
+program
+  .command('search')
+  .description('Search for MCP servers in the registry')
+  .argument('<query>', 'Search query')
+  .option('-c, --category <category>', 'Filter by category')
+  .action(async (query, options) => {
+    try {
+      await searchServers(query, options);
+    } catch (error) {
+      console.error(chalk.red('Error:'), error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('install')
+  .description('Install an MCP server')
+  .argument('<server>', 'Server name or package')
+  .option('-g, --global', 'Install globally')
+  .action(async (server, options) => {
+    try {
+      await installServer(server, options);
+    } catch (error) {
+      console.error(chalk.red('Error:'), error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('list')
+  .alias('ls')
+  .description('List installed MCP servers')
+  .option('-a, --all', 'Show all servers including disabled')
+  .action(async (options) => {
+    try {
+      await listServers(options);
+    } catch (error) {
+      console.error(chalk.red('Error:'), error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('uninstall')
+  .alias('remove')
+  .description('Uninstall an MCP server')
+  .argument('<server>', 'Server name')
+  .action(async (server) => {
+    try {
+      await uninstallServer(server);
+    } catch (error) {
+      console.error(chalk.red('Error:'), error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('enable')
+  .description('Enable an MCP server')
+  .argument('<server>', 'Server name')
+  .action(async (server) => {
+    try {
+      await enableServer(server);
+    } catch (error) {
+      console.error(chalk.red('Error:'), error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('disable')
+  .description('Disable an MCP server')
+  .argument('<server>', 'Server name')
+  .action(async (server) => {
+    try {
+      await disableServer(server);
+    } catch (error) {
+      console.error(chalk.red('Error:'), error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('export')
+  .description('Export MCP configuration')
+  .option('-f, --format <format>', 'Export format (claude|cursor|openclaw)', 'openclaw')
+  .option('-o, --output <path>', 'Output file path')
+  .action(async (options) => {
+    try {
+      await exportConfig(options);
+    } catch (error) {
+      console.error(chalk.red('Error:'), error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+// Template commands (场景模板)
+const template = program
+  .command('template')
+  .alias('t')
+  .description('Scene templates for quick setup');
+
+template
+  .command('list')
+  .description('List available templates')
+  .action(async () => {
+    try {
+      await templateCommand.list();
+    } catch (error) {
+      console.error(chalk.red('Error:'), error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+template
+  .command('use')
+  .description('Use a template')
+  .argument('<template>', 'Template name')
+  .action(async (templateName) => {
+    try {
+      await templateCommand.use(templateName);
+    } catch (error) {
+      console.error(chalk.red('Error:'), error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+// OpenClaw integration commands
+const openclaw = program
+  .command('openclaw')
+  .alias('oc')
+  .description('OpenClaw integration commands');
+
+openclaw
+  .command('setup')
+  .description('Setup MCP servers for OpenClaw')
+  .action(async () => {
+    try {
+      await openclawCommand.setup();
+    } catch (error) {
+      console.error(chalk.red('Error:'), error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+openclaw
+  .command('sync')
+  .description('Sync MCP configuration to OpenClaw')
+  .action(async () => {
+    try {
+      await openclawCommand.sync();
+    } catch (error) {
+      console.error(chalk.red('Error:'), error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+openclaw
+  .command('status')
+  .description('Show OpenClaw MCP configuration status')
+  .action(async () => {
+    try {
+      await openclawCommand.status();
+    } catch (error) {
+      console.error(chalk.red('Error:'), error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+program.parse();

package/src/commands/export.ts

@@ -0,0 +1,127 @@
+import chalk from 'chalk';
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+import YAML from 'yaml';
+
+const CONFIG_DIR = path.join(os.homedir(), '.mcpm');
+const SERVERS_FILE = path.join(CONFIG_DIR, 'servers.json');
+
+async function getInstalledServers(): Promise<Record<string, any>> {
+  if (await fs.pathExists(SERVERS_FILE)) {
+    return await fs.readJson(SERVERS_FILE);
+  }
+  return {};
+}
+
+function generateClaudeConfig(servers: Record<string, any>): any {
+  const mcpServers: Record<string, any> = {};
+  
+  Object.values(servers)
+    .filter((s: any) => s.enabled)
+    .forEach((server: any) => {
+      mcpServers[server.name] = {
+        command: server.command,
+        args: server.args,
+        env: server.env
+      };
+    });
+
+  return { mcpServers };
+}
+
+function generateCursorConfig(servers: Record<string, any>): any {
+  // Cursor uses a similar format to Claude
+  return generateClaudeConfig(servers);
+}
+
+function generateOpenClawConfig(servers: Record<string, any>): any {
+  // OpenClaw specific format
+  const mcpServers: Record<string, any> = {};
+  
+  Object.values(servers)
+    .filter((s: any) => s.enabled)
+    .forEach((server: any) => {
+      mcpServers[server.name] = {
+        command: server.command,
+        args: server.args,
+        env: server.env,
+        enabled: true
+      };
+    });
+
+  return {
+    version: '1.0',
+    mcpServers,
+    metadata: {
+      exportedAt: new Date().toISOString(),
+      tool: 'mcp-server-manager',
+      version: '0.1.0'
+    }
+  };
+}
+
+export async function exportConfig(options: { format?: string; output?: string }): Promise<void> {
+  const format = options.format || 'openclaw';
+  const servers = await getInstalledServers();
+  const enabledServers = Object.values(servers).filter((s: any) => s.enabled);
+
+  if (enabledServers.length === 0) {
+    console.log(chalk.yellow('⚠️  No enabled servers to export.'));
+    console.log(chalk.gray('Enable servers with:'), chalk.cyan('mcpm enable <server>'));
+    return;
+  }
+
+  console.log(chalk.blue('📤 Exporting MCP configuration...'));
+  console.log(chalk.gray(`Format: ${format}`));
+  console.log(chalk.gray(`Servers: ${enabledServers.length}`));
+  console.log();
+
+  let config: any;
+  let ext: string;
+
+  switch (format) {
+    case 'claude':
+      config = generateClaudeConfig(servers);
+      ext = 'json';
+      break;
+    case 'cursor':
+      config = generateCursorConfig(servers);
+      ext = 'json';
+      break;
+    case 'openclaw':
+    default:
+      config = generateOpenClawConfig(servers);
+      ext = 'yaml';
+      break;
+  }
+
+  const outputPath = options.output || `mcp-config.${ext}`;
+  
+  if (ext === 'json') {
+    await fs.writeJson(outputPath, config, { spaces: 2 });
+  } else {
+    await fs.writeFile(outputPath, YAML.stringify(config));
+  }
+
+  console.log(chalk.green('✅ Configuration exported successfully!'));
+  console.log(chalk.gray(`Output: ${path.resolve(outputPath)}`));
+  console.log();
+  console.log(chalk.blue('💡 Next steps:'));
+  
+  switch (format) {
+    case 'claude':
+      console.log(chalk.gray('  1. Copy the configuration to Claude Desktop settings'));
+      console.log(chalk.gray('  2. Restart Claude Desktop'));
+      break;
+    case 'cursor':
+      console.log(chalk.gray('  1. Copy the configuration to Cursor MCP settings'));
+      console.log(chalk.gray('  2. Restart Cursor'));
+      break;
+    case 'openclaw':
+    default:
+      console.log(chalk.gray('  1. Run:'), chalk.cyan('mcpm openclaw sync'));
+      console.log(chalk.gray('  2. Or manually copy to OpenClaw MCP configuration'));
+      break;
+  }
+}

package/src/commands/install.ts

@@ -0,0 +1,139 @@
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+
+interface ServerConfig {
+  name: string;
+  command: string;
+  args: string[];
+  env?: Record<string, string>;
+  enabled: boolean;
+  installedAt: string;
+}
+
+const CONFIG_DIR = path.join(os.homedir(), '.mcpm');
+const SERVERS_FILE = path.join(CONFIG_DIR, 'servers.json');
+
+async function ensureConfigDir(): Promise<void> {
+  await fs.ensureDir(CONFIG_DIR);
+}
+
+async function getInstalledServers(): Promise<Record<string, ServerConfig>> {
+  await ensureConfigDir();
+  if (await fs.pathExists(SERVERS_FILE)) {
+    return await fs.readJson(SERVERS_FILE);
+  }
+  return {};
+}
+
+async function saveInstalledServers(servers: Record<string, ServerConfig>): Promise<void> {
+  await ensureConfigDir();
+  await fs.writeJson(SERVERS_FILE, servers, { spaces: 2 });
+}
+
+// Mock installation logic for MVP
+const SERVER_TEMPLATES: Record<string, Partial<ServerConfig>> = {
+  '@modelcontextprotocol/server-postgres': {
+    command: 'docker',
+    args: ['run', '-i', '--rm', 'mcp/postgres'],
+    env: {
+      POSTGRES_HOST: 'localhost',
+      POSTGRES_PORT: '5432',
+      POSTGRES_DB: 'postgres',
+      POSTGRES_USER: 'postgres'
+    }
+  },
+  '@modelcontextprotocol/server-github': {
+    command: 'docker',
+    args: ['run', '-i', '--rm', 'mcp/github'],
+    env: {
+      GITHUB_PERSONAL_ACCESS_TOKEN: ''
+    }
+  },
+  '@modelcontextprotocol/server-filesystem': {
+    command: 'docker',
+    args: ['run', '-i', '--rm', '-v', '${HOME}:/home/user', 'mcp/filesystem'],
+    env: {}
+  }
+};
+
+export async function installServer(serverName: string, options: { global?: boolean }): Promise<void> {
+  console.log(chalk.blue('📦 Installing MCP server...'));
+  console.log(chalk.gray(`Server: ${serverName}`));
+  console.log();
+
+  const installedServers = await getInstalledServers();
+
+  // Check if already installed
+  if (installedServers[serverName]) {
+    console.log(chalk.yellow(`⚠️  Server "${serverName}" is already installed.`));
+    console.log(chalk.gray('Use "mcpm update" to update or "mcpm uninstall" to remove.'));
+    return;
+  }
+
+  // Get server template
+  const template = SERVER_TEMPLATES[serverName];
+  if (!template) {
+    console.log(chalk.yellow(`⚠️  Server "${serverName}" not found in registry.`));
+    console.log(chalk.gray('Searching for similar servers...'));
+    // TODO: Implement fuzzy search
+    return;
+  }
+
+  // Interactive configuration
+  const config: ServerConfig = {
+    name: serverName,
+    command: template.command || 'docker',
+    args: template.args || [],
+    env: {},
+    enabled: true,
+    installedAt: new Date().toISOString()
+  };
+
+  // Prompt for environment variables
+  if (template.env) {
+    console.log(chalk.blue('🔧 Configuration required:\n'));
+    
+    for (const [key, defaultValue] of Object.entries(template.env)) {
+      const { value } = await inquirer.prompt([{
+        type: 'input',
+        name: 'value',
+        message: `${key}${defaultValue ? ` (default: ${defaultValue})` : ''}:`,
+        default: defaultValue || undefined
+      }]);
+      
+      if (value) {
+        config.env = config.env || {};
+        config.env[key] = value;
+      }
+    }
+  }
+
+  // Confirm installation
+  const { confirm } = await inquirer.prompt([{
+    type: 'confirm',
+    name: 'confirm',
+    message: 'Install this server?',
+    default: true
+  }]);
+
+  if (!confirm) {
+    console.log(chalk.gray('Installation cancelled.'));
+    return;
+  }
+
+  // Save configuration
+  installedServers[serverName] = config;
+  await saveInstalledServers(installedServers);
+
+  console.log();
+  console.log(chalk.green('✅ Server installed successfully!'));
+  console.log(chalk.gray(`Configuration saved to: ${SERVERS_FILE}`));
+  console.log();
+  console.log(chalk.blue('💡 Next steps:'));
+  console.log(chalk.gray('  - Enable the server:'), chalk.cyan(`mcpm enable ${serverName}`));
+  console.log(chalk.gray('  - Export configuration:'), chalk.cyan('mcpm export'));
+  console.log(chalk.gray('  - View all servers:'), chalk.cyan('mcpm list'));
+}

package/src/commands/list.ts

@@ -0,0 +1,75 @@
+import chalk from 'chalk';
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+
+interface ServerConfig {
+  name: string;
+  command: string;
+  args: string[];
+  env?: Record<string, string>;
+  enabled: boolean;
+  installedAt: string;
+}
+
+const CONFIG_DIR = path.join(os.homedir(), '.mcpm');
+const SERVERS_FILE = path.join(CONFIG_DIR, 'servers.json');
+
+async function getInstalledServers(): Promise<Record<string, ServerConfig>> {
+  if (await fs.pathExists(SERVERS_FILE)) {
+    return await fs.readJson(SERVERS_FILE);
+  }
+  return {};
+}
+
+export async function listServers(options: { all?: boolean }): Promise<void> {
+  console.log(chalk.blue('📋 Installed MCP servers\n'));
+
+  const servers = await getInstalledServers();
+  const serverList = Object.values(servers);
+
+  if (serverList.length === 0) {
+    console.log(chalk.yellow('No servers installed yet.'));
+    console.log(chalk.gray('Search and install servers with:'), chalk.cyan('mcpm search <query>'));
+    return;
+  }
+
+  // Filter enabled/disabled
+  const filteredServers = options.all 
+    ? serverList 
+    : serverList.filter(s => s.enabled);
+
+  if (filteredServers.length === 0 && !options.all) {
+    console.log(chalk.yellow('No enabled servers.'));
+    console.log(chalk.gray('Use --all to see disabled servers.'));
+    return;
+  }
+
+  // Group by status
+  const enabledServers = filteredServers.filter(s => s.enabled);
+  const disabledServers = filteredServers.filter(s => !s.enabled);
+
+  if (enabledServers.length > 0) {
+    console.log(chalk.green(`✅ Enabled (${enabledServers.length}):\n`));
+    enabledServers.forEach((server, index) => {
+      console.log(chalk.white(`  ${index + 1}. ${chalk.bold(server.name)}`));
+      console.log(chalk.gray(`     Command: ${server.command} ${server.args.join(' ')}`));
+      console.log(chalk.gray(`     Installed: ${new Date(server.installedAt).toLocaleDateString()}`));
+      console.log();
+    });
+  }
+
+  if (disabledServers.length > 0) {
+    console.log(chalk.gray(`⏸️  Disabled (${disabledServers.length}):\n`));
+    disabledServers.forEach((server, index) => {
+      console.log(chalk.gray(`  ${index + 1}. ${server.name}`));
+      console.log();
+    });
+  }
+
+  console.log(chalk.blue('💡 Commands:'));
+  console.log(chalk.gray('  Enable:'), chalk.cyan('mcpm enable <server>'));
+  console.log(chalk.gray('  Disable:'), chalk.cyan('mcpm disable <server>'));
+  console.log(chalk.gray('  Uninstall:'), chalk.cyan('mcpm uninstall <server>'));
+  console.log(chalk.gray('  Export:'), chalk.cyan('mcpm export'));
+}