@meldocio/mcp-stdio-proxy 1.0.13 → 1.0.15

package/README.md

@@ -27,6 +27,7 @@ This command will:
 - ✅ Automatically find your Claude Desktop configuration file
 - ✅ Add Meldoc MCP configuration (preserving existing MCP servers)
 - ✅ Create the config file and directory if needed
+- ✅ Check if already installed (won't duplicate if already configured)
 - ✅ Show you the next steps
 
 After running `install`, you just need to:
@@ -35,6 +36,21 @@ After running `install`, you just need to:
 
 Done! 🎉
 
+### Uninstalling
+
+To remove Meldoc MCP from Claude Desktop:
+
+```bash
+npx @meldocio/mcp-stdio-proxy@latest uninstall
+```
+
+This will:
+- ✅ Remove Meldoc MCP configuration from Claude Desktop
+- ✅ Preserve other MCP servers
+- ✅ Clean up empty `mcpServers` object if needed
+
+After running `uninstall`, restart Claude Desktop for changes to take effect.
+
 ---
 
 ### Manual Installation
@@ -212,11 +228,14 @@ When you ask Claude to do something with your documentation:
 
 ## Working Commands
 
-### Installation command
+### Installation commands
 
 ```bash
 # Automatically configure Claude Desktop for Meldoc MCP
 npx @meldocio/mcp-stdio-proxy@latest install
+
+# Remove Meldoc MCP configuration from Claude Desktop
+npx @meldocio/mcp-stdio-proxy@latest uninstall
 ```
 
 ### Authentication commands
@@ -252,6 +271,9 @@ npx @meldocio/mcp-stdio-proxy@latest config get-workspace
 ```bash
 # Automatically configure Claude Desktop
 npx @meldocio/mcp-stdio-proxy@latest install
+
+# Remove configuration
+npx @meldocio/mcp-stdio-proxy@latest uninstall
 ```
 
 ### Help

package/bin/cli.js

@@ -218,6 +218,27 @@ function getClaudeDesktopConfigPath() {
   }
 }
 
+/**
+ * Get expected Meldoc MCP configuration
+ */
+function getExpectedMeldocConfig() {
+  return {
+    command: 'npx',
+    args: ['-y', '@meldocio/mcp-stdio-proxy@latest']
+  };
+}
+
+/**
+ * Check if two configurations are equal (deep comparison)
+ */
+function configsEqual(config1, config2) {
+  if (!config1 || !config2) return false;
+  if (config1.command !== config2.command) return false;
+  if (!Array.isArray(config1.args) || !Array.isArray(config2.args)) return false;
+  if (config1.args.length !== config2.args.length) return false;
+  return config1.args.every((arg, i) => arg === config2.args[i]);
+}
+
 /**
  * Handle install command - automatically configure Claude Desktop
  */
@@ -228,6 +249,7 @@ function handleInstall() {
     
     const configPath = getClaudeDesktopConfigPath();
     const configDir = path.dirname(configPath);
+    const expectedConfig = getExpectedMeldocConfig();
     
     logger.info(`Config file location: ${logger.highlight(configPath)}`);
     console.log();
@@ -257,29 +279,39 @@ function handleInstall() {
     
     // Check if meldoc is already configured
     if (config.mcpServers.meldoc) {
-      logger.warn('Meldoc MCP is already configured in Claude Desktop');
-      console.log();
-      logger.info('Current configuration:');
-      console.log('  ' + logger.highlight(JSON.stringify(config.mcpServers.meldoc, null, 2)));
-      console.log();
+      const existingConfig = config.mcpServers.meldoc;
+      const isEqual = configsEqual(existingConfig, expectedConfig);
       
-      // Ask if user wants to update
-      logger.info('To update the configuration, you can manually edit the file or remove it first.');
-      console.log();
-      logger.success('Installation check complete - Meldoc MCP is already configured!');
-      console.log();
-      logger.info('Next steps:');
-      console.log('  1. Restart Claude Desktop (if you haven\'t already)');
-      console.log('  2. Run: ' + logger.highlight('npx @meldocio/mcp-stdio-proxy auth login'));
-      console.log();
-      process.exit(0);
+      if (isEqual) {
+        logger.success('Meldoc MCP is already configured correctly!');
+        console.log();
+        logger.info('Current configuration:');
+        console.log('  ' + logger.highlight(JSON.stringify(existingConfig, null, 2)));
+        console.log();
+        logger.info('No changes needed. Next steps:');
+        console.log('  1. Restart Claude Desktop (if you haven\'t already)');
+        console.log('  2. Run: ' + logger.highlight('npx @meldocio/mcp-stdio-proxy auth login'));
+        console.log();
+        process.exit(0);
+      } else {
+        logger.warn('Meldoc MCP is already configured, but with different settings');
+        console.log();
+        logger.info('Current configuration:');
+        console.log('  ' + logger.highlight(JSON.stringify(existingConfig, null, 2)));
+        console.log();
+        logger.info('Expected configuration:');
+        console.log('  ' + logger.highlight(JSON.stringify(expectedConfig, null, 2)));
+        console.log();
+        logger.info('To update the configuration, run:');
+        console.log('  ' + logger.highlight('npx @meldocio/mcp-stdio-proxy uninstall'));
+        console.log('  ' + logger.highlight('npx @meldocio/mcp-stdio-proxy install'));
+        console.log();
+        process.exit(0);
+      }
     }
     
     // Add meldoc configuration
-    config.mcpServers.meldoc = {
-      command: 'npx',
-      args: ['-y', '@meldocio/mcp-stdio-proxy@latest']
-    };
+    config.mcpServers.meldoc = expectedConfig;
     
     // Create directory if it doesn't exist
     if (!fs.existsSync(configDir)) {
@@ -330,10 +362,7 @@ function handleInstall() {
     console.log('  2. Adding this configuration:');
     console.log('     ' + logger.highlight(JSON.stringify({
       mcpServers: {
-        meldoc: {
-          command: 'npx',
-          args: ['-y', '@meldocio/mcp-stdio-proxy@latest']
-        }
+        meldoc: getExpectedMeldocConfig()
       }
     }, null, 2)));
     console.log();
@@ -341,6 +370,95 @@ function handleInstall() {
   }
 }
 
+/**
+ * Handle uninstall command - remove Meldoc MCP configuration from Claude Desktop
+ */
+function handleUninstall() {
+  try {
+    logger.section('🗑️  Uninstalling Meldoc MCP from Claude Desktop');
+    console.log();
+    
+    const configPath = getClaudeDesktopConfigPath();
+    
+    logger.info(`Config file location: ${logger.highlight(configPath)}`);
+    console.log();
+    
+    // Check if config file exists
+    if (!fs.existsSync(configPath)) {
+      logger.warn('Claude Desktop configuration file not found');
+      logger.info('Meldoc MCP is not configured (nothing to remove)');
+      console.log();
+      process.exit(0);
+    }
+    
+    // Read existing config
+    let config = {};
+    try {
+      const content = fs.readFileSync(configPath, 'utf8');
+      config = JSON.parse(content);
+    } catch (error) {
+      logger.error(`Failed to read config file: ${error.message}`);
+      process.exit(1);
+    }
+    
+    // Check if meldoc is configured
+    if (!config.mcpServers || !config.mcpServers.meldoc) {
+      logger.warn('Meldoc MCP is not configured in Claude Desktop');
+      logger.info('Nothing to remove');
+      console.log();
+      process.exit(0);
+    }
+    
+    // Show what will be removed
+    logger.info('Current Meldoc configuration:');
+    console.log('  ' + logger.highlight(JSON.stringify(config.mcpServers.meldoc, null, 2)));
+    console.log();
+    
+    // Remove meldoc configuration
+    delete config.mcpServers.meldoc;
+    
+    // If mcpServers is now empty, remove it too
+    if (Object.keys(config.mcpServers).length === 0) {
+      delete config.mcpServers;
+    }
+    
+    // Write config file back
+    const configContent = JSON.stringify(config, null, 2);
+    fs.writeFileSync(configPath, configContent, 'utf8');
+    
+    logger.success('Meldoc MCP configuration removed successfully!');
+    console.log();
+    
+    // Count remaining MCP servers
+    if (config.mcpServers && Object.keys(config.mcpServers).length > 0) {
+      const remainingServers = Object.keys(config.mcpServers);
+      logger.info(`Remaining MCP server(s): ${remainingServers.join(', ')}`);
+      console.log();
+    } else {
+      logger.info('No other MCP servers configured');
+      console.log();
+    }
+    
+    // Next steps
+    logger.section('✅ Uninstallation Complete!');
+    console.log();
+    logger.info('Next steps:');
+    console.log('  1. Restart Claude Desktop for changes to take effect');
+    console.log('  2. To reinstall, run: ' + logger.highlight('npx @meldocio/mcp-stdio-proxy install'));
+    console.log();
+    
+    process.exit(0);
+  } catch (error) {
+    logger.error(`Uninstallation failed: ${error.message}`);
+    console.log();
+    logger.info('You can manually remove Meldoc MCP by:');
+    console.log('  1. Opening the config file: ' + logger.highlight(getClaudeDesktopConfigPath()));
+    console.log('  2. Removing the "meldoc" entry from "mcpServers" object');
+    console.log();
+    process.exit(1);
+  }
+}
+
 /**
  * Handle help command
  */
@@ -379,12 +497,17 @@ function handleHelp() {
   console.log('    Automatically configure Claude Desktop for Meldoc MCP');
   console.log();
   
+  console.log('  ' + logger.highlight('uninstall'));
+  console.log('    Remove Meldoc MCP configuration from Claude Desktop');
+  console.log();
+  
   console.log('  ' + logger.highlight('help'));
   console.log('    Show this help message');
   console.log();
   
   console.log(logger.label('Examples:'));
   console.log('  ' + logger.highlight('npx @meldocio/mcp-stdio-proxy install'));
+  console.log('  ' + logger.highlight('npx @meldocio/mcp-stdio-proxy uninstall'));
   console.log('  ' + logger.highlight('npx @meldocio/mcp-stdio-proxy auth login'));
   console.log('  ' + logger.highlight('npx @meldocio/mcp-stdio-proxy config set-workspace my-workspace'));
   console.log('  ' + logger.highlight('npx @meldocio/mcp-stdio-proxy config list-workspaces'));
@@ -407,6 +530,7 @@ function showUsageHints() {
   console.log('  ' + logger.highlight('config get-workspace') + ' - Get current workspace');
   console.log('  ' + logger.highlight('config list-workspaces') + ' - List workspaces');
   console.log('  ' + logger.highlight('install') + '            - Configure Claude Desktop');
+  console.log('  ' + logger.highlight('uninstall') + '          - Remove configuration');
   console.log('  ' + logger.highlight('help') + '              - Show detailed help');
   console.log();
   console.log(logger.label('For more information, run:'));
@@ -434,6 +558,8 @@ async function main() {
     handleHelp();
   } else if (command === 'install') {
     handleInstall();
+  } else if (command === 'uninstall') {
+    handleUninstall();
   } else if (command === 'auth') {
     if (subcommand === 'login') {
       await handleAuthLogin();
@@ -461,9 +587,18 @@ async function main() {
       process.exit(1);
     }
   } else {
-    // Unknown command - might be for main proxy
-    // Return control to main proxy handler
-    return;
+    // Unknown command
+    logger.error(`Unknown command: ${command}`);
+    console.log('\n' + logger.label('Available commands:'));
+    console.log('  ' + logger.highlight('install') + '        - Configure Claude Desktop');
+    console.log('  ' + logger.highlight('uninstall') + '      - Remove configuration');
+    console.log('  ' + logger.highlight('auth') + ' <cmd>      - Authentication commands');
+    console.log('  ' + logger.highlight('config') + ' <cmd>    - Configuration commands');
+    console.log('  ' + logger.highlight('help') + '           - Show help');
+    console.log();
+    console.log(logger.label('Run') + ' ' + logger.highlight('npx @meldocio/mcp-stdio-proxy help') + ' ' + logger.label('for more information'));
+    console.log();
+    process.exit(1);
   }
 }
 
@@ -481,5 +616,6 @@ module.exports = {
   handleConfigSetWorkspace,
   handleConfigGetWorkspace,
   handleConfigListWorkspaces,
-  handleInstall
+  handleInstall,
+  handleUninstall
 };

package/bin/meldoc-mcp-proxy.js

@@ -9,11 +9,15 @@ const chalk = require('chalk');
 
 // Check for CLI commands first
 const args = process.argv.slice(2);
-if (args.length > 0 && (args[0] === 'auth' || args[0] === 'config')) {
+if (args.length > 0) {
+  const command = args[0];
   // Handle CLI commands - cli.js will handle and exit
-  require('./cli');
-  // Don't exit here - cli.js will handle process.exit() after async operations complete
-  return;
+  if (command === 'auth' || command === 'config' || command === 'install' || 
+      command === 'uninstall' || command === 'help' || command === '--help' || command === '-h') {
+    require('./cli');
+    // Don't exit here - cli.js will handle process.exit() after async operations complete
+    return;
+  }
 }
 
 // Get package info - try multiple paths for different installation scenarios

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meldocio/mcp-stdio-proxy",
-  "version": "1.0.13",
+  "version": "1.0.15",
   "description": "MCP stdio proxy for meldoc - connects Claude Desktop to meldoc MCP API",
   "bin": {
     "meldoc-mcp": "bin/meldoc-mcp-proxy.js"