@meldocio/mcp-stdio-proxy 1.0.12 → 1.0.13

package/README.md

@@ -15,6 +15,32 @@ This is a bridge between Claude Desktop and Meldoc. After setup, Claude will be
 
 ## Quick Setup
 
+### Automatic Installation (Recommended) ✨
+
+The easiest way to set up Meldoc MCP is using the automatic installer:
+
+```bash
+npx @meldocio/mcp-stdio-proxy@latest install
+```
+
+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
+- ✅ Show you the next steps
+
+After running `install`, you just need to:
+1. Restart Claude Desktop
+2. Run `npx @meldocio/mcp-stdio-proxy@latest auth login`
+
+Done! 🎉
+
+---
+
+### Manual Installation
+
+If you prefer to configure manually, follow these steps:
+
 ### Step 1: Find Claude Desktop configuration file
 
 Open the configuration file depending on your operating system:
@@ -186,6 +212,13 @@ When you ask Claude to do something with your documentation:
 
 ## Working Commands
 
+### Installation command
+
+```bash
+# Automatically configure Claude Desktop for Meldoc MCP
+npx @meldocio/mcp-stdio-proxy@latest install
+```
+
 ### Authentication commands
 
 ```bash
@@ -214,6 +247,13 @@ npx @meldocio/mcp-stdio-proxy@latest config set-workspace workspace-name
 npx @meldocio/mcp-stdio-proxy@latest config get-workspace
 ```
 
+### Installation
+
+```bash
+# Automatically configure Claude Desktop
+npx @meldocio/mcp-stdio-proxy@latest install
+```
+
 ### Help
 
 ```bash

package/bin/cli.js

@@ -10,6 +10,9 @@ const axios = require('axios');
 const https = require('https');
 const chalk = require('chalk');
 const logger = require('../lib/logger');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
 
 const API_URL = getApiUrl();
 const APP_URL = getAppUrl();
@@ -195,6 +198,149 @@ async function handleConfigListWorkspaces() {
   }
 }
 
+/**
+ * Get Claude Desktop config file path based on OS
+ */
+function getClaudeDesktopConfigPath() {
+  const platform = os.platform();
+  const homeDir = os.homedir();
+  
+  if (platform === 'darwin') {
+    // macOS
+    return path.join(homeDir, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+  } else if (platform === 'win32') {
+    // Windows
+    const appData = process.env.APPDATA || path.join(homeDir, 'AppData', 'Roaming');
+    return path.join(appData, 'Claude', 'claude_desktop_config.json');
+  } else {
+    // Linux and others
+    return path.join(homeDir, '.config', 'Claude', 'claude_desktop_config.json');
+  }
+}
+
+/**
+ * Handle install command - automatically configure Claude Desktop
+ */
+function handleInstall() {
+  try {
+    logger.section('🚀 Installing Meldoc MCP for Claude Desktop');
+    console.log();
+    
+    const configPath = getClaudeDesktopConfigPath();
+    const configDir = path.dirname(configPath);
+    
+    logger.info(`Config file location: ${logger.highlight(configPath)}`);
+    console.log();
+    
+    // Read existing config or create new one
+    let config = {};
+    let configExists = false;
+    
+    if (fs.existsSync(configPath)) {
+      try {
+        const content = fs.readFileSync(configPath, 'utf8');
+        config = JSON.parse(content);
+        configExists = true;
+        logger.info('Found existing Claude Desktop configuration');
+      } catch (error) {
+        logger.warn(`Failed to parse existing config: ${error.message}`);
+        logger.info('Will create a new configuration file');
+      }
+    } else {
+      logger.info('Configuration file does not exist, will create it');
+    }
+    
+    // Ensure mcpServers object exists
+    if (!config.mcpServers) {
+      config.mcpServers = {};
+    }
+    
+    // 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();
+      
+      // 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);
+    }
+    
+    // Add meldoc configuration
+    config.mcpServers.meldoc = {
+      command: 'npx',
+      args: ['-y', '@meldocio/mcp-stdio-proxy@latest']
+    };
+    
+    // Create directory if it doesn't exist
+    if (!fs.existsSync(configDir)) {
+      logger.info(`Creating directory: ${configDir}`);
+      fs.mkdirSync(configDir, { recursive: true });
+    }
+    
+    // Write config file
+    const configContent = JSON.stringify(config, null, 2);
+    fs.writeFileSync(configPath, configContent, 'utf8');
+    
+    logger.success('Configuration added successfully!');
+    console.log();
+    
+    // Show what was added
+    logger.info('Added MCP server configuration:');
+    console.log('  ' + logger.highlight(JSON.stringify(config.mcpServers.meldoc, null, 2)));
+    console.log();
+    
+    // Count other MCP servers
+    const otherServers = Object.keys(config.mcpServers).filter(key => key !== 'meldoc');
+    if (otherServers.length > 0) {
+      logger.info(`Found ${otherServers.length} other MCP server(s): ${otherServers.join(', ')}`);
+      console.log();
+    }
+    
+    // Next steps
+    logger.section('✅ Installation Complete!');
+    console.log();
+    logger.info('Next steps:');
+    console.log();
+    console.log('  1. ' + logger.label('Restart Claude Desktop'));
+    console.log('     Completely close and reopen Claude Desktop for changes to take effect.');
+    console.log();
+    console.log('  2. ' + logger.label('Authenticate with Meldoc'));
+    console.log('     Run: ' + logger.highlight('npx @meldocio/mcp-stdio-proxy auth login'));
+    console.log();
+    console.log('  3. ' + logger.label('Start using Claude with Meldoc!'));
+    console.log('     Ask Claude to read, search, or update your documentation.');
+    console.log();
+    
+    process.exit(0);
+  } catch (error) {
+    logger.error(`Installation failed: ${error.message}`);
+    console.log();
+    logger.info('You can manually configure Claude Desktop by:');
+    console.log('  1. Opening the config file: ' + logger.highlight(getClaudeDesktopConfigPath()));
+    console.log('  2. Adding this configuration:');
+    console.log('     ' + logger.highlight(JSON.stringify({
+      mcpServers: {
+        meldoc: {
+          command: 'npx',
+          args: ['-y', '@meldocio/mcp-stdio-proxy@latest']
+        }
+      }
+    }, null, 2)));
+    console.log();
+    process.exit(1);
+  }
+}
+
 /**
  * Handle help command
  */
@@ -229,11 +375,16 @@ function handleHelp() {
   console.log('    List all available workspaces');
   console.log();
   
+  console.log('  ' + logger.highlight('install'));
+  console.log('    Automatically configure Claude Desktop for Meldoc MCP');
+  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 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'));
@@ -255,6 +406,7 @@ function showUsageHints() {
   console.log('  ' + logger.highlight('config set-workspace') + ' - Set workspace alias');
   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('help') + '              - Show detailed help');
   console.log();
   console.log(logger.label('For more information, run:'));
@@ -280,6 +432,8 @@ async function main() {
   
   if (command === 'help' || command === '--help' || command === '-h') {
     handleHelp();
+  } else if (command === 'install') {
+    handleInstall();
   } else if (command === 'auth') {
     if (subcommand === 'login') {
       await handleAuthLogin();
@@ -326,5 +480,6 @@ module.exports = {
   handleAuthLogout,
   handleConfigSetWorkspace,
   handleConfigGetWorkspace,
-  handleConfigListWorkspaces
+  handleConfigListWorkspaces,
+  handleInstall
 };

package/package.json

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