@meldocio/mcp-stdio-proxy 1.0.15 → 1.0.17

package/README.md

@@ -1,5 +1,8 @@
 # Meldoc MCP for Claude Desktop
 
+[![npm version](https://badge.fury.io/js/@meldocio%2Fmcp-stdio-proxy.svg)](https://www.npmjs.com/package/@meldocio/mcp-stdio-proxy)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 This package allows you to connect Claude Desktop to your Meldoc account, so you can use all your documentation directly in Claude.
 
 ## What is this?
@@ -13,6 +16,35 @@ This is a bridge between Claude Desktop and Meldoc. After setup, Claude will be
 
 **No additional installation required** - everything works automatically through Claude Desktop.
 
+## Installation
+
+### Via Claude Marketplace (Recommended) 🚀
+
+The easiest way to install Meldoc MCP is through the Claude Marketplace:
+
+```bash
+# Add the marketplace
+claude plugin marketplace add meldoc/mcp-stdio-proxy
+
+# Install the plugin
+claude plugin install meldoc-mcp@meldoc
+```
+
+After installation:
+
+1. Restart Claude Desktop (or your MCP client)
+2. Run `npx @meldocio/mcp-stdio-proxy@latest auth login` to authenticate
+
+### Via NPM
+
+You can also install directly via npm:
+
+```bash
+npm install -g @meldocio/mcp-stdio-proxy
+```
+
+Then add to your Claude Desktop config file (see Manual Installation below).
+
 ## Quick Setup
 
 ### Automatic Installation (Recommended) ✨
@@ -24,6 +56,7 @@ 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
@@ -31,6 +64,7 @@ This command will:
 - ✅ 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`
 
@@ -45,6 +79,7 @@ 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
@@ -266,7 +301,7 @@ npx @meldocio/mcp-stdio-proxy@latest config set-workspace workspace-name
 npx @meldocio/mcp-stdio-proxy@latest config get-workspace
 ```
 
-### Installation
+### Quick Installation Commands
 
 ```bash
 # Automatically configure Claude Desktop
@@ -292,10 +327,12 @@ If you have multiple workspaces in Meldoc, you need to specify which one to use.
 The system selects a workspace in this order:
 
 1. **Specified in request** - if you explicitly specified `workspaceAlias` or `workspaceId`
-2. **Project file** - if there's a `.meldoc.yml` file in the project folder
+2. **Project file** - if there's a `meldoc.config.yml` file in the project folder (or git repository directory)
 3. **Global setting** - if you set a default workspace
 4. **Automatically** - if you only have one workspace, it will be selected automatically
 
+**Note:** When MCP is used in a git project or directory (e.g., Claude Desktop terminal or any other LLM), the workspace is automatically taken from the `meldoc.config.yml` configuration file if it exists.
+
 ### Setting default workspace
 
 If you have multiple workspaces, set one as default:
@@ -308,14 +345,13 @@ After this, Claude will automatically use this workspace.
 
 ### Workspace for a specific project
 
-If you want different projects to use different workspaces, create a `.meldoc.yml` file in the project root:
+If you want different projects to use different workspaces, create a `meldoc.config.yml` file in the project root:
 
 ```yaml
-context:
-  workspace: workspace-name-for-this-project
+workspaceAlias: workspace-name-for-this-project
 ```
 
-Now when working from this folder, the specified workspace will be used.
+Now when working from this folder (or when MCP is used in a git repository), the specified workspace will be used.
 
 ## What can Claude do with your documentation?
 
@@ -489,9 +525,9 @@ Global settings:
 
 Can be edited manually or through CLI commands.
 
-### `.meldoc.yml` (optional)
+### `meldoc.config.yml` (optional)
 
-Project-specific settings. Create in the project root if you need to use a different workspace for this project.
+Project-specific settings. Create in the project root if you need to use a different workspace for this project. When MCP is used in a git project or directory, the workspace is automatically taken from this configuration file if it exists.
 
 ## Requirements
 

package/bin/cli.js

@@ -219,7 +219,54 @@ function getClaudeDesktopConfigPath() {
 }
 
 /**
- * Get expected Meldoc MCP configuration
+ * Get Cursor config file path (project-specific)
+ */
+function getCursorProjectConfigPath() {
+  const cwd = process.cwd();
+  return path.join(cwd, '.cursor', 'mcp.json');
+}
+
+/**
+ * Get Cursor global config file path
+ */
+function getCursorGlobalConfigPath() {
+  const homeDir = os.homedir();
+  return path.join(homeDir, '.cursor', 'mcp.json');
+}
+
+/**
+ * Get local mcp.json path (in current directory)
+ */
+function getLocalMcpJsonPath() {
+  return path.join(process.cwd(), 'mcp.json');
+}
+
+/**
+ * Get Claude Code project config path (.mcp.json)
+ */
+function getClaudeCodeProjectConfigPath() {
+  return path.join(process.cwd(), '.mcp.json');
+}
+
+/**
+ * Get Claude Code user config path (~/.claude.json)
+ */
+function getClaudeCodeUserConfigPath() {
+  return path.join(os.homedir(), '.claude.json');
+}
+
+/**
+ * Get Claude Code local config path (~/.claude.json in project path)
+ * Note: Local scope uses ~/.claude.json but stores project-specific paths
+ */
+function getClaudeCodeLocalConfigPath() {
+  // For local scope, Claude Code uses ~/.claude.json with project-specific paths
+  // This is the same file as user scope, but with different path context
+  return path.join(os.homedir(), '.claude.json');
+}
+
+/**
+ * Get expected Meldoc MCP configuration for Claude Desktop
  */
 function getExpectedMeldocConfig() {
   return {
@@ -228,6 +275,27 @@ function getExpectedMeldocConfig() {
   };
 }
 
+/**
+ * Get expected Meldoc MCP configuration for Cursor (stdio)
+ */
+function getExpectedMeldocConfigForCursor() {
+  return {
+    command: 'npx',
+    args: ['-y', '@meldocio/mcp-stdio-proxy@latest']
+  };
+}
+
+/**
+ * Get expected Meldoc MCP configuration for Claude Code (stdio)
+ */
+function getExpectedMeldocConfigForClaudeCode() {
+  return {
+    type: 'stdio',
+    command: 'npx',
+    args: ['-y', '@meldocio/mcp-stdio-proxy@latest']
+  };
+}
+
 /**
  * Check if two configurations are equal (deep comparison)
  */
@@ -240,9 +308,27 @@ function configsEqual(config1, config2) {
 }
 
 /**
- * Handle install command - automatically configure Claude Desktop
+ * Merge MCP server configurations (preserve existing, add new)
+ */
+function mergeMcpServers(existing, newServer) {
+  const merged = { ...existing };
+  if (!merged.meldoc) {
+    merged.meldoc = newServer;
+  } else {
+    // Check if it's the same config
+    if (configsEqual(merged.meldoc, newServer)) {
+      return { merged, changed: false };
+    }
+    // Update if different
+    merged.meldoc = newServer;
+  }
+  return { merged, changed: true };
+}
+
+/**
+ * Install for Claude Desktop
  */
-function handleInstall() {
+function installClaudeDesktop() {
   try {
     logger.section('🚀 Installing Meldoc MCP for Claude Desktop');
     console.log();
@@ -370,6 +456,447 @@ function handleInstall() {
   }
 }
 
+/**
+ * Install for Cursor (project or global)
+ */
+function installCursor(isGlobal = false) {
+  try {
+    const configPath = isGlobal ? getCursorGlobalConfigPath() : getCursorProjectConfigPath();
+    const configDir = path.dirname(configPath);
+    const expectedConfig = getExpectedMeldocConfigForCursor();
+    
+    logger.section(`🚀 Installing Meldoc MCP for Cursor (${isGlobal ? 'global' : 'project'})`);
+    console.log();
+    
+    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 Cursor MCP 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) {
+      const existingConfig = config.mcpServers.meldoc;
+      const isEqual = configsEqual(existingConfig, expectedConfig);
+      
+      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 Cursor (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 install cursor'));
+        console.log();
+        process.exit(0);
+      }
+    }
+    
+    // Add meldoc configuration
+    config.mcpServers.meldoc = expectedConfig;
+    
+    // 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 Cursor'));
+    console.log('     Completely close and reopen Cursor 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 Cursor with Meldoc!'));
+    console.log('     Ask Cursor to read, search, or update your documentation.');
+    console.log();
+    
+    process.exit(0);
+  } catch (error) {
+    const configPath = isGlobal ? getCursorGlobalConfigPath() : getCursorProjectConfigPath();
+    logger.error(`Installation failed: ${error.message}`);
+    console.log();
+    logger.info('You can manually configure Cursor by:');
+    console.log('  1. Opening the config file: ' + logger.highlight(configPath));
+    console.log('  2. Adding this configuration:');
+    console.log('     ' + logger.highlight(JSON.stringify({
+      mcpServers: {
+        meldoc: getExpectedMeldocConfigForCursor()
+      }
+    }, null, 2)));
+    console.log();
+    process.exit(1);
+  }
+}
+
+/**
+ * Install local mcp.json file
+ */
+function installLocal() {
+  try {
+    logger.section('🚀 Installing Meldoc MCP (Local mcp.json)');
+    console.log();
+    
+    const configPath = getLocalMcpJsonPath();
+    const expectedConfig = getExpectedMeldocConfig();
+    
+    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 mcp.json 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) {
+      const existingConfig = config.mcpServers.meldoc;
+      const isEqual = configsEqual(existingConfig, expectedConfig);
+      
+      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 your MCP client (if needed)');
+        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('Updating configuration...');
+        console.log();
+      }
+    }
+    
+    // Add/update meldoc configuration
+    config.mcpServers.meldoc = expectedConfig;
+    
+    // Write config file
+    const configContent = JSON.stringify(config, null, 2);
+    fs.writeFileSync(configPath, configContent, 'utf8');
+    
+    logger.success('Configuration ' + (configExists && config.mcpServers.meldoc ? 'updated' : 'added') + ' successfully!');
+    console.log();
+    
+    // Show what was added
+    logger.info('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('Use this mcp.json with your MCP client'));
+    console.log('     This file can be imported or referenced by MCP clients that support JSON configuration.');
+    console.log();
+    console.log('  2. ' + logger.label('Authenticate with Meldoc'));
+    console.log('     Run: ' + logger.highlight('npx @meldocio/mcp-stdio-proxy auth login'));
+    console.log();
+    
+    process.exit(0);
+  } catch (error) {
+    logger.error(`Installation failed: ${error.message}`);
+    console.log();
+    logger.info('You can manually create mcp.json with this configuration:');
+    console.log('     ' + logger.highlight(JSON.stringify({
+      mcpServers: {
+        meldoc: getExpectedMeldocConfig()
+      }
+    }, null, 2)));
+    console.log();
+    process.exit(1);
+  }
+}
+
+/**
+ * Install for Claude Code (project, user, or local scope)
+ */
+function installClaudeCode(scope = 'project') {
+  try {
+    let configPath;
+    if (scope === 'project') {
+      configPath = getClaudeCodeProjectConfigPath();
+    } else if (scope === 'user') {
+      configPath = getClaudeCodeUserConfigPath();
+    } else {
+      // local scope
+      configPath = getClaudeCodeLocalConfigPath();
+    }
+    const configDir = path.dirname(configPath);
+    const expectedConfig = getExpectedMeldocConfigForClaudeCode();
+    
+    logger.section(`🚀 Installing Meldoc MCP for Claude Code (${scope} scope)`);
+    console.log();
+    
+    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 Code MCP 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) {
+      const existingConfig = config.mcpServers.meldoc;
+      // For Claude Code, compare type, command, and args
+      const isEqual = existingConfig.type === expectedConfig.type &&
+                      existingConfig.command === expectedConfig.command &&
+                      Array.isArray(existingConfig.args) &&
+                      Array.isArray(expectedConfig.args) &&
+                      existingConfig.args.length === expectedConfig.args.length &&
+                      existingConfig.args.every((arg, i) => arg === expectedConfig.args[i]);
+      
+      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 Code (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('Updating configuration...');
+        console.log();
+      }
+    }
+    
+    // Add/update meldoc configuration
+    config.mcpServers.meldoc = expectedConfig;
+    
+    // Create directory if it doesn't exist (for user/local scope)
+    if (scope !== 'project' && !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 ' + (configExists && config.mcpServers.meldoc ? 'updated' : 'added') + ' successfully!');
+    console.log();
+    
+    // Show what was added
+    logger.info('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 Code'));
+    console.log('     Completely close and reopen Claude Code 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 Code with Meldoc!'));
+    console.log('     Ask Claude Code to read, search, or update your documentation.');
+    console.log();
+    
+    process.exit(0);
+  } catch (error) {
+    const configPath = scope === 'project' ? getClaudeCodeProjectConfigPath() : getClaudeCodeUserConfigPath();
+    logger.error(`Installation failed: ${error.message}`);
+    console.log();
+    logger.info('You can manually configure Claude Code by:');
+    console.log('  1. Opening the config file: ' + logger.highlight(configPath));
+    console.log('  2. Adding this configuration:');
+    console.log('     ' + logger.highlight(JSON.stringify({
+      mcpServers: {
+        meldoc: getExpectedMeldocConfigForClaudeCode()
+      }
+    }, null, 2)));
+    console.log();
+    logger.info('Or use the CLI command:');
+    console.log('  ' + logger.highlight(`claude mcp add --transport stdio meldoc -- npx -y @meldocio/mcp-stdio-proxy@latest --scope ${scope}`));
+    console.log();
+    process.exit(1);
+  }
+}
+
+/**
+ * Handle install command - automatically configure MCP client
+ */
+function handleInstall(consumer, isLocal) {
+  if (isLocal) {
+    installLocal();
+    return;
+  }
+  
+  const consumerLower = (consumer || 'claude-desktop').toLowerCase();
+  
+  switch (consumerLower) {
+    case 'claude-desktop':
+    case 'claude':
+      installClaudeDesktop();
+      break;
+    case 'cursor':
+      installCursor(false); // Project-specific by default
+      break;
+    case 'cursor-global':
+      installCursor(true);
+      break;
+    case 'claude-code':
+      installClaudeCode('project'); // Project scope by default
+      break;
+    case 'claude-code-user':
+      installClaudeCode('user');
+      break;
+    case 'claude-code-local':
+      installClaudeCode('local');
+      break;
+    default:
+      logger.error(`Unknown consumer: ${consumer}`);
+      console.log();
+      logger.info('Supported consumers:');
+      console.log('  ' + logger.highlight('claude-desktop') + ' (or claude) - Claude Desktop');
+      console.log('  ' + logger.highlight('cursor') + ' - Cursor IDE (project-specific)');
+      console.log('  ' + logger.highlight('cursor-global') + ' - Cursor IDE (global)');
+      console.log('  ' + logger.highlight('claude-code') + ' - Claude Code (project scope)');
+      console.log('  ' + logger.highlight('claude-code-user') + ' - Claude Code (user scope)');
+      console.log('  ' + logger.highlight('claude-code-local') + ' - Claude Code (local scope)');
+      console.log();
+      logger.info('Or use ' + logger.highlight('--local') + ' flag to create local mcp.json');
+      console.log();
+      process.exit(1);
+  }
+}
+
 /**
  * Handle uninstall command - remove Meldoc MCP configuration from Claude Desktop
  */
@@ -493,8 +1020,10 @@ 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('  ' + logger.highlight('install [consumer] [--local]'));
+  console.log('    Automatically configure MCP client for Meldoc MCP');
+  console.log('    Consumers: claude-desktop (default), cursor, cursor-global, claude-code');
+  console.log('    Use --local flag to create local mcp.json file');
   console.log();
   
   console.log('  ' + logger.highlight('uninstall'));
@@ -507,6 +1036,10 @@ function handleHelp() {
   
   console.log(logger.label('Examples:'));
   console.log('  ' + logger.highlight('npx @meldocio/mcp-stdio-proxy install'));
+  console.log('  ' + logger.highlight('npx @meldocio/mcp-stdio-proxy install claude-desktop'));
+  console.log('  ' + logger.highlight('npx @meldocio/mcp-stdio-proxy install cursor'));
+  console.log('  ' + logger.highlight('npx @meldocio/mcp-stdio-proxy install claude-code'));
+  console.log('  ' + logger.highlight('npx @meldocio/mcp-stdio-proxy install --local'));
   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'));
@@ -529,7 +1062,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('install [consumer]') + ' - Configure MCP client');
   console.log('  ' + logger.highlight('uninstall') + '          - Remove configuration');
   console.log('  ' + logger.highlight('help') + '              - Show detailed help');
   console.log();
@@ -557,7 +1090,19 @@ async function main() {
   if (command === 'help' || command === '--help' || command === '-h') {
     handleHelp();
   } else if (command === 'install') {
-    handleInstall();
+    // Parse install arguments
+    let consumer = null;
+    let isLocal = false;
+    
+    for (let i = 1; i < args.length; i++) {
+      if (args[i] === '--local' || args[i] === '-l') {
+        isLocal = true;
+      } else if (!args[i].startsWith('--') && !args[i].startsWith('-')) {
+        consumer = args[i];
+      }
+    }
+    
+    handleInstall(consumer, isLocal);
   } else if (command === 'uninstall') {
     handleUninstall();
   } else if (command === 'auth') {
@@ -617,5 +1162,9 @@ module.exports = {
   handleConfigGetWorkspace,
   handleConfigListWorkspaces,
   handleInstall,
-  handleUninstall
+  handleUninstall,
+  installClaudeDesktop,
+  installCursor,
+  installClaudeCode,
+  installLocal
 };

package/lib/workspace.js

@@ -4,16 +4,16 @@ const yaml = require('js-yaml');
 const { getWorkspaceAlias: getConfigWorkspaceAlias } = require('./config');
 
 /**
- * Find .meldoc.yml file in current directory or parent directories
+ * Find meldoc.config.yml file in current directory or parent directories
  * @param {string} startDir - Starting directory
- * @returns {string|null} Path to .meldoc.yml or null if not found
+ * @returns {string|null} Path to meldoc.config.yml or null if not found
  */
 function findRepoConfig(startDir = process.cwd()) {
   let currentDir = path.resolve(startDir);
   const root = path.parse(currentDir).root;
   
   while (currentDir !== root) {
-    const configPath = path.join(currentDir, '.meldoc.yml');
+    const configPath = path.join(currentDir, 'meldoc.config.yml');
     if (fs.existsSync(configPath)) {
       return configPath;
     }
@@ -24,15 +24,15 @@ function findRepoConfig(startDir = process.cwd()) {
 }
 
 /**
- * Read workspace alias from .meldoc.yml
- * @param {string} configPath - Path to .meldoc.yml
+ * Read workspace alias from meldoc.config.yml
+ * @param {string} configPath - Path to meldoc.config.yml
  * @returns {string|null} Workspace alias or null
  */
 function readRepoConfig(configPath) {
   try {
     const content = fs.readFileSync(configPath, 'utf8');
     const config = yaml.load(content);
-    return config?.context?.workspace || null;
+    return config?.workspaceAlias || null;
   } catch (error) {
     return null;
   }
@@ -41,7 +41,7 @@ function readRepoConfig(configPath) {
 /**
  * Resolve workspace alias for request
  * Priority:
- * 1. Repo config (.meldoc.yml) - optional, can be skipped
+ * 1. Repo config (meldoc.config.yml) - optional, can be skipped
  * 2. Global config (~/.meldoc/config.json)
  * 3. No header (let server choose automatically)
  * @param {boolean} useRepoConfig - Whether to check repo config (optional)

package/package.json

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