@meldocio/mcp-stdio-proxy 1.0.11 → 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:
@@ -65,7 +91,7 @@ Completely close and reopen Claude Desktop for the changes to take effect.
 Open a terminal and run:
 
 ```bash
-npx @meldoc/mcp@latest auth login
+npx @meldocio/mcp-stdio-proxy@latest auth login
 ```
 
 Follow the on-screen instructions - you'll need to open a link in your browser and enter a code.
@@ -81,7 +107,7 @@ For Claude to work with your documentation, you need to log in to your Meldoc ac
 The easiest way is to use the login command:
 
 ```bash
-npx @meldoc/mcp@latest auth login
+npx @meldocio/mcp-stdio-proxy@latest auth login
 ```
 
 **What will happen:**
@@ -128,7 +154,7 @@ export MELDOC_ACCESS_TOKEN=your_token_here
 To check if you're logged in:
 
 ```bash
-npx @meldoc/mcp@latest auth status
+npx @meldocio/mcp-stdio-proxy@latest auth status
 ```
 
 ### Logging out
@@ -136,7 +162,7 @@ npx @meldoc/mcp@latest auth status
 To log out and remove saved data:
 
 ```bash
-npx @meldoc/mcp@latest auth logout
+npx @meldocio/mcp-stdio-proxy@latest auth logout
 ```
 
 ### Automatic token refresh
@@ -159,8 +185,8 @@ Yes, but you need to switch between them using the `auth logout` and `auth login
 
 ### What to do if something doesn't work?
 
-1. Check that you're logged in: `npx @meldoc/mcp@latest auth status`
-2. Check workspace: `npx @meldoc/mcp@latest config get-workspace`
+1. Check that you're logged in: `npx @meldocio/mcp-stdio-proxy@latest auth status`
+2. Check workspace: `npx @meldocio/mcp-stdio-proxy@latest config get-workspace`
 3. See the "Troubleshooting" section above
 4. If nothing helps, create an issue on GitHub
 
@@ -186,17 +212,24 @@ 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
 # Log in to account (browser will open)
-npx @meldoc/mcp@latest auth login
+npx @meldocio/mcp-stdio-proxy@latest auth login
 
 # Check if you're logged in
-npx @meldoc/mcp@latest auth status
+npx @meldocio/mcp-stdio-proxy@latest auth status
 
 # Log out of account
-npx @meldoc/mcp@latest auth logout
+npx @meldocio/mcp-stdio-proxy@latest auth logout
 ```
 
 ### Workspace management commands
@@ -205,20 +238,27 @@ If you have multiple workspaces, you can manage them:
 
 ```bash
 # View all available workspaces
-npx @meldoc/mcp@latest config list-workspaces
+npx @meldocio/mcp-stdio-proxy@latest config list-workspaces
 
 # Set default workspace
-npx @meldoc/mcp@latest config set-workspace workspace-name
+npx @meldocio/mcp-stdio-proxy@latest config set-workspace workspace-name
 
 # View current workspace
-npx @meldoc/mcp@latest config get-workspace
+npx @meldocio/mcp-stdio-proxy@latest config get-workspace
+```
+
+### Installation
+
+```bash
+# Automatically configure Claude Desktop
+npx @meldocio/mcp-stdio-proxy@latest install
 ```
 
 ### Help
 
 ```bash
 # Show all available commands
-npx @meldoc/mcp@latest help
+npx @meldocio/mcp-stdio-proxy@latest help
 ```
 
 ## Working with Workspaces
@@ -239,7 +279,7 @@ The system selects a workspace in this order:
 If you have multiple workspaces, set one as default:
 
 ```bash
-npx @meldoc/mcp@latest config set-workspace workspace-name
+npx @meldocio/mcp-stdio-proxy@latest config set-workspace workspace-name
 ```
 
 After this, Claude will automatically use this workspace.
@@ -303,13 +343,13 @@ Claude will automatically select the right tool and execute the request.
 1. Run the login command:
 
    ```bash
-   npx @meldoc/mcp@latest auth login
+   npx @meldocio/mcp-stdio-proxy@latest auth login
    ```
 
 2. Or check if you're logged in:
 
    ```bash
-   npx @meldoc/mcp@latest auth status
+   npx @meldocio/mcp-stdio-proxy@latest auth status
    ```
 
 3. If using a token directly, make sure it's specified in Claude Desktop configuration
@@ -323,13 +363,13 @@ If you have multiple workspaces, you need to specify which one to use:
 1. View the list of available workspaces:
 
    ```bash
-   npx @meldoc/mcp@latest config list-workspaces
+   npx @meldocio/mcp-stdio-proxy@latest config list-workspaces
    ```
 
 2. Set one as default:
 
    ```bash
-   npx @meldoc/mcp@latest config set-workspace workspace-name
+   npx @meldocio/mcp-stdio-proxy@latest config set-workspace workspace-name
    ```
 
 ### Error: "Invalid token" - invalid token
@@ -339,13 +379,13 @@ If you have multiple workspaces, you need to specify which one to use:
 1. If you used `auth login`, just log in again:
 
    ```bash
-   npx @meldoc/mcp@latest auth login
+   npx @meldocio/mcp-stdio-proxy@latest auth login
    ```
 
 2. Check status:
 
    ```bash
-   npx @meldoc/mcp@latest auth status
+   npx @meldocio/mcp-stdio-proxy@latest auth status
    ```
 
 3. If using a token manually, make sure it hasn't expired and is specified correctly

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();
@@ -64,7 +67,7 @@ async function handleAuthStatus() {
   if (!status || !status.authenticated) {
     logger.error('Not authenticated');
     console.log('\n' + logger.label('To authenticate, run:'));
-    console.log('  ' + logger.highlight('npx @meldoc/mcp auth login') + '\n');
+    console.log('  ' + logger.highlight('npx @meldocio/mcp-stdio-proxy auth login') + '\n');
     process.exit(1);
   }
   
@@ -99,7 +102,7 @@ function handleConfigSetWorkspace(alias) {
   if (!alias) {
     logger.error('Workspace alias is required');
     console.log('\n' + logger.label('Usage:'));
-    console.log('  ' + logger.highlight('npx @meldoc/mcp config set-workspace <alias>') + '\n');
+    console.log('  ' + logger.highlight('npx @meldocio/mcp-stdio-proxy config set-workspace <alias>') + '\n');
     process.exit(1);
   }
   
@@ -133,7 +136,7 @@ async function handleConfigListWorkspaces() {
     if (!tokenInfo) {
       logger.error('Not authenticated');
       console.log('\n' + logger.label('To authenticate, run:'));
-      console.log('  ' + logger.highlight('npx @meldoc/mcp auth login') + '\n');
+      console.log('  ' + logger.highlight('npx @meldocio/mcp-stdio-proxy auth login') + '\n');
       process.exit(1);
     }
     
@@ -184,7 +187,7 @@ async function handleConfigListWorkspaces() {
       if (errorData.code === 'AUTH_REQUIRED' || errorData.data?.code === 'AUTH_REQUIRED') {
         logger.error('Not authenticated');
         console.log('\n' + logger.label('To authenticate, run:'));
-        console.log('  ' + logger.highlight('npx @meldoc/mcp auth login') + '\n');
+        console.log('  ' + logger.highlight('npx @meldocio/mcp-stdio-proxy auth login') + '\n');
         process.exit(1);
       }
       logger.error(`Error: ${errorData.message || error.message}`);
@@ -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,14 +375,19 @@ 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 @meldoc/mcp auth login'));
-  console.log('  ' + logger.highlight('npx @meldoc/mcp config set-workspace my-workspace'));
-  console.log('  ' + logger.highlight('npx @meldoc/mcp config list-workspaces'));
+  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'));
   console.log();
   
   process.exit(0);
@@ -255,10 +406,11 @@ 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:'));
-  console.log('  ' + logger.highlight('npx @meldoc/mcp help') + '\n');
+  console.log('  ' + logger.highlight('npx @meldocio/mcp-stdio-proxy help') + '\n');
   process.exit(0);
 }
 
@@ -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();
@@ -290,7 +444,7 @@ async function main() {
     } else {
       logger.error(`Unknown auth command: ${subcommand}`);
       console.log('\n' + logger.label('Usage:'));
-      console.log('  ' + logger.highlight('npx @meldoc/mcp auth <login|status|logout>') + '\n');
+      console.log('  ' + logger.highlight('npx @meldocio/mcp-stdio-proxy auth <login|status|logout>') + '\n');
       process.exit(1);
     }
   } else if (command === 'config') {
@@ -303,7 +457,7 @@ async function main() {
     } else {
       logger.error(`Unknown config command: ${subcommand}`);
       console.log('\n' + logger.label('Usage:'));
-      console.log('  ' + logger.highlight('npx @meldoc/mcp config <set-workspace|get-workspace|list-workspaces>') + '\n');
+      console.log('  ' + logger.highlight('npx @meldocio/mcp-stdio-proxy config <set-workspace|get-workspace|list-workspaces>') + '\n');
       process.exit(1);
     }
   } else {
@@ -326,5 +480,6 @@ module.exports = {
   handleAuthLogout,
   handleConfigSetWorkspace,
   handleConfigGetWorkspace,
-  handleConfigListWorkspaces
+  handleConfigListWorkspaces,
+  handleInstall
 };

package/bin/meldoc-mcp-proxy.js

@@ -729,7 +729,7 @@ async function handleToolsCall(request) {
                 type: 'text',
                 text: JSON.stringify({
                   authenticated: false,
-                  message: 'Not authenticated. Run: npx @meldoc/mcp@latest auth login'
+                  message: 'Not authenticated. Run: npx @meldocio/mcp-stdio-proxy@latest auth login'
                 }, null, 2)
               }
             ]
@@ -772,7 +772,7 @@ async function handleToolsCall(request) {
         content: [
           {
             type: 'text',
-            text: 'To authenticate, run the following command:\n\nnpx @meldoc/mcp@latest auth login'
+            text: 'To authenticate, run the following command:\n\nnpx @meldocio/mcp-stdio-proxy@latest auth login'
           }
         ]
       }
@@ -808,7 +808,7 @@ async function processSingleRequest(request) {
   const tokenInfo = await getAccessToken();
   if (!tokenInfo) {
     sendError(request.id, CUSTOM_ERROR_CODES.AUTH_REQUIRED, 
-              'Meldoc token not found. Set MELDOC_ACCESS_TOKEN environment variable or run: npx @meldoc/mcp@latest auth login', {
+              'Meldoc token not found. Set MELDOC_ACCESS_TOKEN environment variable or run: npx @meldocio/mcp-stdio-proxy@latest auth login', {
                 code: 'AUTH_REQUIRED',
                 hint: 'Use meldoc.auth_login_instructions tool to get login command'
               });
@@ -942,7 +942,7 @@ async function processSingleRequest(request) {
         
         // Check for AUTH_REQUIRED error
         if (errorCode === 'AUTH_REQUIRED' || errorData.code === 'AUTH_REQUIRED') {
-          const message = 'Authentication required. Run: npx @meldoc/mcp@latest auth login';
+          const message = 'Authentication required. Run: npx @meldocio/mcp-stdio-proxy@latest auth login';
           sendError(request.id, CUSTOM_ERROR_CODES.AUTH_REQUIRED, message, {
             code: 'AUTH_REQUIRED',
             hint: 'Use auth_login_instructions tool to get login command'
@@ -1032,7 +1032,7 @@ async function processSingleRequest(request) {
       
       // Check for AUTH_REQUIRED
       if (errorCode === 'AUTH_REQUIRED' || errorData.code === 'AUTH_REQUIRED') {
-        const message = 'Authentication required. Run: npx @meldoc/mcp@latest auth login';
+        const message = 'Authentication required. Run: npx @meldocio/mcp-stdio-proxy@latest auth login';
         sendError(request.id, CUSTOM_ERROR_CODES.AUTH_REQUIRED, message, {
           code: 'AUTH_REQUIRED',
           hint: 'Use auth_login_instructions tool to get login command'
@@ -1105,7 +1105,7 @@ async function processSingleRequest(request) {
       
       // Check for AUTH_REQUIRED
       if (errorDataCode === 'AUTH_REQUIRED') {
-        const message = 'Authentication required. Run: npx @meldoc/mcp@latest auth login';
+        const message = 'Authentication required. Run: npx @meldocio/mcp-stdio-proxy@latest auth login';
         sendError(request.id, CUSTOM_ERROR_CODES.AUTH_REQUIRED, message, {
           code: 'AUTH_REQUIRED',
           hint: 'Use auth_login_instructions tool to get login command'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meldocio/mcp-stdio-proxy",
-  "version": "1.0.11",
+  "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"
@@ -32,6 +32,9 @@
     "url": "https://github.com/meldoc/mcp-stdio-proxy/issues"
   },
   "homepage": "https://github.com/meldoc/mcp-stdio-proxy#readme",
+  "publishConfig": {
+    "access": "public"
+  },
   "dependencies": {
     "axios": "^1.6.0",
     "chalk": "^4.1.2",