devdoq-install-mcp 1.0.0

package/index.js

@@ -0,0 +1,162 @@
+#!/usr/bin/env node
+
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { execSync } from 'child_process';
+
+// Get npx absolute path
+function getNpxPath() {
+  try {
+    const isWin = os.platform() === 'win32';
+    const cmd = isWin ? 'where npx' : 'which npx';
+    const output = execSync(cmd, { encoding: 'utf8' }).trim();
+    if (output) {
+      // Possible multiple lines on some OS
+      return output.split('\n')[0].trim();
+    }
+  } catch (err) {
+    // Ignore error
+  }
+  return 'npx'; // Fallback
+}
+
+function printUsage() {
+  console.log(`
+Usage: npx devdoq-install-mcp <url> <apiKey> [options]
+
+Options:
+  --client <name>   Specify which client to configure (claude, cline, all). Default is all.
+  --name <name>     Name of the MCP server. Default is 'devdoq'.
+
+Example:
+  npx devdoq-install-mcp https://mcp.devdoq.com/mcp mcp_abc123 --client claude
+  `);
+}
+
+const args = process.argv.slice(2);
+const positional = [];
+let clientType = 'all';
+let serverName = 'devdoq';
+
+for (let i = 0; i < args.length; i++) {
+  if (args[i] === '--client') {
+    clientType = args[++i];
+  } else if (args[i] === '--name') {
+    serverName = args[++i];
+  } else if (args[i] === '--help' || args[i] === '-h') {
+    printUsage();
+    process.exit(0);
+  } else if (!args[i].startsWith('-')) {
+    positional.push(args[i]);
+  }
+}
+
+if (positional.length < 2) {
+  console.error("Error: Missing <url> or <apiKey>\n");
+  printUsage();
+  process.exit(1);
+}
+
+const targetUrl = positional[0];
+const targetApiKey = positional[1];
+
+const platform = os.platform();
+const homeDir = os.homedir();
+const appData = process.env.APPDATA || path.join(homeDir, 'AppData', 'Roaming');
+
+const CONFIG_PATHS = {
+  claude: platform === 'darwin'
+    ? path.join(homeDir, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json')
+    : platform === 'win32'
+    ? path.join(appData, 'Claude', 'claude_desktop_config.json')
+    : null,
+
+  cline_vscode: platform === 'darwin'
+    ? path.join(homeDir, 'Library', 'Application Support', 'Code', 'User', 'globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json')
+    : platform === 'win32'
+    ? path.join(appData, 'Code', 'User', 'globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json')
+    : path.join(homeDir, '.config', 'Code', 'User', 'globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json'),
+
+  cline_cursor: platform === 'darwin'
+    ? path.join(homeDir, 'Library', 'Application Support', 'Cursor', 'User', 'globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json')
+    : platform === 'win32'
+    ? path.join(appData, 'Cursor', 'User', 'globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json')
+    : path.join(homeDir, '.config', 'Cursor', 'User', 'globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json'),
+};
+
+const npxPath = getNpxPath();
+
+const mcpConfigBlock = {
+  command: npxPath,
+  args: [
+    "-y",
+    "mcp-remote",
+    targetUrl,
+    "--header",
+    `Authorization: Bearer ${targetApiKey}`
+  ]
+};
+
+function updateJsonConfig(filePath, serverName, configObj) {
+  let data = {};
+  if (fs.existsSync(filePath)) {
+    try {
+      const content = fs.readFileSync(filePath, 'utf8');
+      data = JSON.parse(content);
+    } catch (err) {
+      console.error(`Error reading or parsing ${filePath}: ${err.message}`);
+      return false;
+    }
+  }
+
+  if (!data.mcpServers) {
+    data.mcpServers = {};
+  }
+
+  data.mcpServers[serverName] = configObj;
+
+  try {
+    // Ensure directory exists
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, JSON.stringify(data, null, 2), 'utf8');
+    console.log(`✅ Successfully updated: ${filePath}`);
+    return true;
+  } catch (err) {
+    console.error(`❌ Failed to write ${filePath}: ${err.message}`);
+    return false;
+  }
+}
+
+console.log(`\nConfiguring '${serverName}' MCP server with URL: ${targetUrl}`);
+console.log(`Using npx path: ${npxPath}\n`);
+
+let updatedAny = false;
+
+const clientsToAttempt = [];
+if (clientType === 'all' || clientType === 'claude') clientsToAttempt.push(CONFIG_PATHS.claude);
+if (clientType === 'all' || clientType === 'cline') {
+  clientsToAttempt.push(CONFIG_PATHS.cline_vscode);
+  clientsToAttempt.push(CONFIG_PATHS.cline_cursor);
+}
+
+for (const targetPath of clientsToAttempt) {
+  if (targetPath) {
+    // Only attempt to write if the directory exists OR if it's the exact requested client
+    // For "all", we only populate if the parent config directory exists to avoid cluttering unused apps
+    if (fs.existsSync(path.dirname(targetPath)) || clientType !== 'all') {
+      const success = updateJsonConfig(targetPath, serverName, mcpConfigBlock);
+      if (success) updatedAny = true;
+    } else {
+      console.log(`(Skipped) App data not found for: ${targetPath}`);
+    }
+  }
+}
+
+if (!updatedAny) {
+  console.log(`\n⚠️  Could not automatically configure native configuration files.`);
+}
+
+console.log(`\nIf your client (e.g. Cursor, Windsurf) requires manual configuration, simply copy and paste the JSON block below into its MCP Settings:\n`);
+console.log(`"${serverName}": ${JSON.stringify(mcpConfigBlock, null, 2)}`);
+console.log(`\nDone! Restart your MCP client to apply changes.`);

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "devdoq-install-mcp",
+  "version": "1.0.0",
+  "description": "Auto-configure MCP server connections for Claude Desktop, Cline, and others.",
+  "main": "index.js",
+  "bin": {
+    "devdoq-install-mcp": "index.js"
+  },
+  "type": "module",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "mcp",
+    "claude",
+    "cursor"
+  ],
+  "author": "",
+  "license": "MIT"
+}