@meldocio/mcp-stdio-proxy 1.0.22 → 1.0.24

package/lib/cli/commands.js

@@ -0,0 +1,277 @@
+/**
+ * CLI Command Handlers
+ *
+ * Handles all CLI commands for auth, config, and installation.
+ */
+
+const { interactiveLogin } = require('../core/device-flow');
+const { deleteCredentials } = require('../core/credentials');
+const { getAuthStatus, getAccessToken } = require('../core/auth');
+const { setWorkspaceAlias, getWorkspaceAlias } = require('../core/config');
+const { getApiUrl, getAppUrl } = require('../core/constants');
+const { createInstaller } = require('../install/installers');
+const axios = require('axios');
+const https = require('https');
+const chalk = require('chalk');
+const logger = require('../core/logger');
+
+const API_URL = getApiUrl();
+const APP_URL = getAppUrl();
+
+/**
+ * Authentication Commands
+ */
+
+/**
+ * Handle auth login command
+ */
+async function handleAuthLogin() {
+  try {
+    await interactiveLogin({
+      autoOpen: true,
+      showQR: false,
+      timeout: 120000,
+      apiBaseUrl: API_URL,
+      appUrl: APP_URL
+    });
+    process.exit(0);
+  } catch (error) {
+    process.exit(1);
+  }
+}
+
+/**
+ * Handle auth status command
+ */
+async function handleAuthStatus() {
+  const status = await getAuthStatus();
+  if (!status || !status.authenticated) {
+    logger.error('Not authenticated');
+    console.log('\n' + logger.label('To authenticate, run:'));
+    console.log('  ' + logger.highlight('npx @meldocio/mcp-stdio-proxy auth login') + '\n');
+    process.exit(1);
+  }
+
+  logger.section('🔑 Authentication Status');
+
+  if (status.type === 'user_session' && status.user) {
+    logger.item('Email', logger.value(status.user.email));
+    if (status.expiresAt) {
+      logger.item('Token expires', logger.value(new Date(status.expiresAt).toLocaleString()));
+    }
+  } else {
+    logger.item('Type', logger.value(status.type));
+  }
+
+  console.log();
+  process.exit(0);
+}
+
+/**
+ * Handle auth logout command
+ */
+async function handleAuthLogout() {
+  deleteCredentials();
+  logger.success('Logged out successfully');
+  process.exit(0);
+}
+
+/**
+ * Configuration Commands
+ */
+
+/**
+ * Handle config set-workspace command
+ */
+function handleConfigSetWorkspace(alias) {
+  if (!alias) {
+    logger.error('Workspace alias is required');
+    console.log('\n' + logger.label('Usage:'));
+    console.log('  ' + logger.highlight('npx @meldocio/mcp-stdio-proxy config set-workspace <alias>') + '\n');
+    process.exit(1);
+  }
+
+  try {
+    setWorkspaceAlias(alias);
+    logger.success(`Workspace set to: ${logger.highlight(alias)}`);
+    process.exit(0);
+  } catch (error) {
+    logger.error(`Failed to set workspace: ${error.message}`);
+    process.exit(1);
+  }
+}
+
+/**
+ * Handle config get-workspace command
+ */
+function handleConfigGetWorkspace() {
+  const alias = getWorkspaceAlias();
+  if (alias) {
+    console.log(logger.highlight(alias));
+  }
+  process.exit(0);
+}
+
+/**
+ * Handle config list-workspaces command
+ */
+async function handleConfigListWorkspaces() {
+  try {
+    const tokenInfo = await getAccessToken();
+    if (!tokenInfo) {
+      logger.error('Not authenticated');
+      console.log('\n' + logger.label('To authenticate, run:'));
+      console.log('  ' + logger.highlight('npx @meldocio/mcp-stdio-proxy auth login') + '\n');
+      process.exit(1);
+    }
+
+    // Call MCP tool meldoc.list_workspaces via POST /mcp/v1/rpc
+    const response = await axios.post(`${API_URL}/mcp/v1/rpc`, {
+      jsonrpc: '2.0',
+      id: 1,
+      method: 'tools/call',
+      params: {
+        name: 'meldoc.list_workspaces',
+        arguments: {}
+      }
+    }, {
+      headers: {
+        'Authorization': `Bearer ${tokenInfo.token}`,
+        'Content-Type': 'application/json'
+      },
+      timeout: 10000,
+      httpsAgent: new https.Agent({ keepAlive: true })
+    });
+
+    if (response.data.error) {
+      logger.error(`Error: ${response.data.error.message}`);
+      process.exit(1);
+    }
+
+    const workspaces = response.data.result?.workspaces || [];
+    if (workspaces.length === 0) {
+      logger.info('No workspaces available');
+      process.exit(0);
+    }
+
+    logger.section('📁 Available Workspaces');
+    for (const ws of workspaces) {
+      const role = ws.role || 'member';
+      const roleColor = role === 'owner' ? chalk.red : role === 'admin' ? chalk.yellow : chalk.gray;
+      logger.item(
+        `${logger.highlight(ws.alias)} ${chalk.gray('(' + ws.name + ')')}`,
+        roleColor(`[${role}]`)
+      );
+    }
+    console.log();
+
+    process.exit(0);
+  } catch (error) {
+    if (error.response?.data?.error) {
+      const errorData = error.response.data.error;
+      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 @meldocio/mcp-stdio-proxy auth login') + '\n');
+        process.exit(1);
+      }
+      logger.error(`Error: ${errorData.message || error.message}`);
+    } else {
+      logger.error(`Error: ${error.message}`);
+    }
+    process.exit(1);
+  }
+}
+
+/**
+ * Installation Commands
+ */
+
+/**
+ * Handle install command - automatically configure MCP client
+ */
+function handleInstall(consumer, isLocal) {
+  if (isLocal) {
+    const installer = createInstaller('local');
+    const result = installer.install();
+    process.exit(result.result === 'error' ? 1 : 0);
+    return;
+  }
+
+  const consumerLower = (consumer || 'claude-desktop').toLowerCase();
+  let client, scope;
+
+  switch (consumerLower) {
+    case 'claude-desktop':
+    case 'claude':
+      client = 'claude-desktop';
+      scope = 'project';
+      break;
+    case 'cursor':
+      client = 'cursor';
+      scope = 'project';
+      break;
+    case 'cursor-global':
+      client = 'cursor';
+      scope = 'global';
+      break;
+    case 'claude-code':
+      client = 'claude-code';
+      scope = 'project';
+      break;
+    case 'claude-code-user':
+      client = 'claude-code';
+      scope = 'user';
+      break;
+    case 'claude-code-local':
+      client = 'claude-code';
+      scope = '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);
+      return;
+  }
+
+  // Use new unified installer
+  const installer = createInstaller(client, scope);
+  const result = installer.install();
+  process.exit(result.result === 'error' ? 1 : 0);
+}
+
+/**
+ * Handle uninstall command - remove Meldoc MCP configuration
+ */
+function handleUninstall() {
+  // Default to Claude Desktop for backward compatibility
+  const installer = createInstaller('claude-desktop');
+  const result = installer.uninstall();
+  process.exit(result.result === 'error' ? 1 : 0);
+}
+
+module.exports = {
+  // Auth commands
+  handleAuthLogin,
+  handleAuthStatus,
+  handleAuthLogout,
+
+  // Config commands
+  handleConfigSetWorkspace,
+  handleConfigGetWorkspace,
+  handleConfigListWorkspaces,
+
+  // Installation commands
+  handleInstall,
+  handleUninstall
+};

package/lib/cli/formatters.js

@@ -0,0 +1,137 @@
+/**
+ * CLI Output Formatters
+ *
+ * Handles help text, usage hints, and other formatted CLI output.
+ */
+
+const logger = require('../core/logger');
+
+/**
+ * Show detailed help message with all commands and examples
+ */
+function handleHelp() {
+  console.log('\n' + logger.section('📖 Meldoc MCP CLI Help'));
+  console.log();
+
+  console.log(logger.label('Available Commands:'));
+  console.log();
+
+  console.log('  ' + logger.highlight('auth login'));
+  console.log('    Authenticate with Meldoc using device flow');
+  console.log();
+
+  console.log('  ' + logger.highlight('auth status'));
+  console.log('    Check authentication status');
+  console.log();
+
+  console.log('  ' + logger.highlight('auth logout'));
+  console.log('    Log out and clear credentials');
+  console.log();
+
+  console.log('  ' + logger.highlight('config set-workspace <alias>'));
+  console.log('    Set the active workspace alias');
+  console.log();
+
+  console.log('  ' + logger.highlight('config get-workspace'));
+  console.log('    Get the current workspace alias');
+  console.log();
+
+  console.log('  ' + logger.highlight('config list-workspaces'));
+  console.log('    List all available workspaces');
+  console.log();
+
+  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'));
+  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 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'));
+  console.log('  ' + logger.highlight('npx @meldocio/mcp-stdio-proxy config list-workspaces'));
+  console.log();
+
+  process.exit(0);
+}
+
+/**
+ * Show brief usage hints when no arguments provided
+ */
+function showUsageHints() {
+  console.log('\n' + logger.section('🔧 Meldoc MCP CLI'));
+  console.log();
+  console.log(logger.label('Available commands:'));
+  console.log('  ' + logger.highlight('auth login') + '        - Authenticate with Meldoc');
+  console.log('  ' + logger.highlight('auth status') + '       - Check authentication status');
+  console.log('  ' + logger.highlight('auth logout') + '       - Log out');
+  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 [consumer]') + ' - Configure MCP client');
+  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:'));
+  console.log('  ' + logger.highlight('npx @meldocio/mcp-stdio-proxy help') + '\n');
+  process.exit(0);
+}
+
+/**
+ * Show unknown command error with available commands
+ */
+function showUnknownCommandError(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);
+}
+
+/**
+ * Show unknown auth subcommand error
+ */
+function showUnknownAuthCommandError(subcommand) {
+  logger.error(`Unknown auth command: ${subcommand}`);
+  console.log('\n' + logger.label('Usage:'));
+  console.log('  ' + logger.highlight('npx @meldocio/mcp-stdio-proxy auth <login|status|logout>') + '\n');
+  process.exit(1);
+}
+
+/**
+ * Show unknown config subcommand error
+ */
+function showUnknownConfigCommandError(subcommand) {
+  logger.error(`Unknown config command: ${subcommand}`);
+  console.log('\n' + logger.label('Usage:'));
+  console.log('  ' + logger.highlight('npx @meldocio/mcp-stdio-proxy config <set-workspace|get-workspace|list-workspaces>') + '\n');
+  process.exit(1);
+}
+
+module.exports = {
+  handleHelp,
+  showUsageHints,
+  showUnknownCommandError,
+  showUnknownAuthCommandError,
+  showUnknownConfigCommandError
+};

package/lib/core/constants.js

@@ -0,0 +1,98 @@
+/**
+ * Default configuration constants
+ * Production values used when environment variables are not set
+ */
+
+// Production API URL
+const DEFAULT_API_URL = 'https://api.meldoc.io';
+
+// Production App URL (frontend)
+const DEFAULT_APP_URL = 'https://app.meldoc.io';
+
+/**
+ * Request timeout configuration
+ * 25 seconds - less than Claude Desktop's 30s timeout to allow for proper error handling
+ */
+const REQUEST_TIMEOUT = 25000;
+
+/**
+ * Log levels for severity filtering
+ */
+const LOG_LEVELS = {
+  ERROR: 0,
+  WARN: 1,
+  INFO: 2,
+  DEBUG: 3
+};
+
+/**
+ * Default log level names mapped to numeric values
+ */
+const LOG_LEVEL_NAMES = {
+  0: 'ERROR',
+  1: 'WARN',
+  2: 'INFO',
+  3: 'DEBUG'
+};
+
+/**
+ * MCP protocol version
+ */
+const MCP_PROTOCOL_VERSION = '2025-06-18';
+
+/**
+ * Server capability flags
+ */
+const SERVER_CAPABILITIES = {
+  TOOLS: true,
+  PROMPTS: false,
+  RESOURCES: false,
+  LOGGING: false
+};
+
+/**
+ * Get API URL from environment or use production default
+ */
+function getApiUrl() {
+  return process.env.MELDOC_API_URL || DEFAULT_API_URL;
+}
+
+/**
+ * Get App URL from environment or use production default
+ */
+function getAppUrl() {
+  return process.env.MELDOC_APP_URL || DEFAULT_APP_URL;
+}
+
+/**
+ * Get log level from environment variable
+ * @param {string} [level] - Log level string (ERROR, WARN, INFO, DEBUG)
+ * @returns {number} Numeric log level
+ */
+function getLogLevel(level) {
+  const upper = (level || '').toUpperCase();
+  return LOG_LEVELS[upper] !== undefined ? LOG_LEVELS[upper] : LOG_LEVELS.ERROR;
+}
+
+/**
+ * Get log level name from numeric value
+ * @param {number} level - Numeric log level
+ * @returns {string} Log level name
+ */
+function getLogLevelName(level) {
+  return LOG_LEVEL_NAMES[level] || 'UNKNOWN';
+}
+
+module.exports = {
+  DEFAULT_API_URL,
+  DEFAULT_APP_URL,
+  REQUEST_TIMEOUT,
+  LOG_LEVELS,
+  LOG_LEVEL_NAMES,
+  MCP_PROTOCOL_VERSION,
+  SERVER_CAPABILITIES,
+  getApiUrl,
+  getAppUrl,
+  getLogLevel,
+  getLogLevelName
+};

package/lib/http/client.js

@@ -0,0 +1,61 @@
+/**
+ * HTTP Client for MCP Backend Communication
+ *
+ * Handles HTTP requests to the Meldoc API backend.
+ */
+
+const axios = require('axios');
+const https = require('https');
+const { getApiUrl, REQUEST_TIMEOUT } = require('../core/constants');
+const { getAccessToken } = require('../core/auth');
+const { resolveWorkspaceAlias } = require('../core/workspace');
+
+/**
+ * Make an authenticated JSON-RPC request to the backend
+ * @param {Object} request - JSON-RPC request object
+ * @returns {Promise<Object>} Response data
+ */
+async function makeBackendRequest(request) {
+  const apiUrl = getApiUrl();
+  const rpcEndpoint = `${apiUrl}/mcp/v1/rpc`;
+
+  // Get access token
+  const tokenInfo = await getAccessToken();
+  if (!tokenInfo) {
+    throw new Error('Not authenticated');
+  }
+
+  // Ensure request has jsonrpc field
+  const requestWithJsonRpc = {
+    ...request,
+    jsonrpc: request.jsonrpc || '2.0'
+  };
+
+  // Resolve workspace if not provided
+  const workspaceAlias = await resolveWorkspaceAlias();
+
+  // Build headers
+  const headers = {
+    'Authorization': `Bearer ${tokenInfo.token}`,
+    'Content-Type': 'application/json'
+  };
+
+  // Add workspace header if available
+  if (workspaceAlias) {
+    headers['X-Workspace-Alias'] = workspaceAlias;
+  }
+
+  // Make request
+  const response = await axios.post(rpcEndpoint, requestWithJsonRpc, {
+    headers,
+    timeout: REQUEST_TIMEOUT,
+    httpsAgent: new https.Agent({ keepAlive: true }),
+    validateStatus: () => true // Accept all status codes
+  });
+
+  return response;
+}
+
+module.exports = {
+  makeBackendRequest
+};