Update configuration command

.github/workflows/pr-validator.yml

@@ -12,6 +12,10 @@ jobs:
 
     steps:
     - uses: actions/checkout@v4
+    - name: Install system dependencies
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y libsecret-1-dev
     - uses: actions/setup-node@v4
       with:
         node-version: 20

package.json

@@ -9,6 +9,9 @@
     "packages/openapi-mcp-server",
     "packages/mcp"
   ],
+  "bin": {
+    "twilio-mcp-server": "./packages/mcp/build/index.js"
+  },
   "scripts": {
     "build": "npm run build --workspaces",
     "lint": "npm run lint --workspaces",

packages/mcp/README.md

@@ -28,6 +28,8 @@ The easiest way to get started is to edit the configuration of your client to po
 }
 ```
 
+Alternatively, use the `npx -y @twilio-alpha config` command to set your credentials, choose tags and services, and automatically save MCP client configuration for Cursor or Claude Desktop.
+
 Visit [Twilio API Keys docs](https://www.twilio.com/docs/iam/api-keys) for information on how to find/create your apiKey/apiSecret.
 
 ## Configuration Parameters

packages/mcp/package.json

@@ -36,6 +36,7 @@
     "@twilio-alpha/openapi-mcp-server": "0.1.2",
     "@apidevtools/swagger-parser": "^10.1.1",
     "@modelcontextprotocol/sdk": "^1.7.0",
+    "chalk": "^5.4.1",
     "inquirer": "^12.5.0",
     "keytar": "^7.9.0",
     "minimist": "^1.2.8",

packages/mcp/src/config.ts

@@ -0,0 +1,316 @@
+/* eslint-disable no-console */
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+
+import { auth, isValidTwilioSid } from '@app/utils';
+
+interface Credentials {
+  accountSid: string;
+  apiKey: string;
+  apiSecret: string;
+}
+
+interface MCPConfig {
+  mcpServers: {
+    [key: string]: {
+      command: string;
+      args: string[];
+    };
+  };
+}
+
+interface OpenAPIConfig {
+  tags?: string;
+  services?: string;
+}
+
+const CONFIG_PATHS = {
+  CURSOR: path.join(os.homedir(), '.cursor', 'mcp.json'),
+  CLAUDE: path.join(
+    os.homedir(),
+    'Library',
+    'Application Support',
+    'Claude',
+    'claude_desktop_config.json',
+  ),
+} as const;
+
+const MCP_SERVER_NAME = 'twilio';
+const DEFAULT_SERVICE = 'twilio_api_v2010';
+
+async function readConfigFile(configPath: string): Promise<MCPConfig> {
+  try {
+    if (fs.existsSync(configPath)) {
+      return JSON.parse(fs.readFileSync(configPath, 'utf8'));
+    }
+  } catch (error) {
+    console.error(
+      chalk.red('✗'),
+      `Error reading configuration file: ${
+        error instanceof Error ? error.message : 'Unknown error'
+      }`,
+    );
+  }
+  return { mcpServers: {} };
+}
+
+async function configureCursor(executableArgs: string[]) {
+  console.info(chalk.green('👀'), 'Checking for Cursor configuration...');
+
+  const cursorConfig = await readConfigFile(CONFIG_PATHS.CURSOR);
+
+  if (MCP_SERVER_NAME in cursorConfig.mcpServers) {
+    console.info(
+      chalk.yellow('→'),
+      "Twilio MCP server already configured; we'll update it with the new configuration.",
+    );
+  }
+
+  cursorConfig.mcpServers[MCP_SERVER_NAME] = {
+    command: 'npx',
+    args: executableArgs,
+  };
+
+  try {
+    fs.writeFileSync(
+      CONFIG_PATHS.CURSOR,
+      JSON.stringify(cursorConfig, null, 2),
+    );
+    console.info(chalk.green('✔'), 'Cursor configuration set!');
+  } catch (error) {
+    console.error(
+      chalk.red('✗'),
+      `Failed to write Cursor configuration: ${
+        error instanceof Error ? error.message : 'Unknown error'
+      }`,
+    );
+    process.exit(1);
+  }
+}
+
+async function configureClaudeDesktop(executableArgs: string[]) {
+  console.info(
+    chalk.green('👀'),
+    'Checking for Claude Desktop configuration...',
+  );
+
+  const existingConfig = await readConfigFile(CONFIG_PATHS.CLAUDE);
+
+  if (MCP_SERVER_NAME in existingConfig.mcpServers) {
+    console.info(
+      chalk.yellow('→'),
+      "Twilio MCP server already configured; we'll update it with the new configuration.",
+    );
+  }
+
+  existingConfig.mcpServers[MCP_SERVER_NAME] = {
+    command: 'npx',
+    args: executableArgs,
+  };
+
+  try {
+    fs.writeFileSync(
+      CONFIG_PATHS.CLAUDE,
+      JSON.stringify(existingConfig, null, 2),
+    );
+    console.info(chalk.green('✔'), 'Claude Desktop configuration set!');
+  } catch (error) {
+    console.error(
+      chalk.red('✗'),
+      `Failed to write Claude Desktop configuration: ${
+        error instanceof Error ? error.message : 'Unknown error'
+      }`,
+    );
+    process.exit(1);
+  }
+}
+
+async function promptForOverwrite(currentSid: string): Promise<boolean> {
+  const { overwrite } = await inquirer.prompt([
+    {
+      type: 'confirm',
+      name: 'overwrite',
+      message: `Credentials already set for account \`${currentSid}\`. Overwrite?`,
+      default: false,
+    },
+  ]);
+  return overwrite;
+}
+
+async function promptForCredentials(): Promise<Credentials> {
+  const answers = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'accountSid',
+      message: 'Enter your Twilio account SID:',
+      validate: (input) =>
+        isValidTwilioSid(input, 'AC') || 'Invalid Account SID format',
+    },
+    {
+      type: 'password',
+      name: 'apiKey',
+      message: 'Enter your Twilio API Key SID:',
+      validate: (input) =>
+        isValidTwilioSid(input, 'SK') || 'Invalid API Key SID format',
+    },
+    {
+      type: 'password',
+      name: 'apiSecret',
+      message: 'Enter your Twilio API Key Secret:',
+      validate: (input) => input.length > 0 || 'API Secret is required',
+    },
+  ]);
+
+  return answers;
+}
+
+async function promptForOpenAPIConfig(): Promise<OpenAPIConfig> {
+  const tagsAnswers = await inquirer.prompt([
+    {
+      type: 'confirm',
+      name: 'tags',
+      message: 'Do you want to use specific Twilio OpenAPI tags?',
+      default: false,
+    },
+  ]);
+
+  if (tagsAnswers.tags) {
+    const { tags } = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'tags',
+        message:
+          'Enter the Twilio OpenAPI tags you want to use (comma-separated):',
+        validate: (input) => {
+          if (!input.trim()) {
+            return 'Tags cannot be empty';
+          }
+
+          const tagList = input.split(',').map((tag) => tag.trim());
+
+          return tagList.every((tag) => tag.length > 0) || 'Invalid tag format';
+        },
+      },
+    ]);
+    return { tags };
+  }
+
+  const servicesAnswers = await inquirer.prompt([
+    {
+      type: 'confirm',
+      name: 'services',
+      message: 'Do you want to use specific Twilio OpenAPI services?',
+      default: false,
+    },
+  ]);
+
+  if (servicesAnswers.services) {
+    const { services } = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'services',
+        message:
+          'Enter the Twilio OpenAPI services you want to use (comma-separated):',
+        validate: (input) => {
+          if (!input.trim()) {
+            return 'Services cannot be empty';
+          }
+
+          const serviceList = input.split(',').map((service) => service.trim());
+
+          return (
+            serviceList.every((service) => service.length > 0) ||
+            'Invalid service format'
+          );
+        },
+      },
+    ]);
+    return { services };
+  }
+
+  console.info(
+    chalk.yellow('→'),
+    `No services selected; the default service will be used, \`${DEFAULT_SERVICE}\`.`,
+  );
+  return {};
+}
+
+async function configureClient(executableArgs: string[]) {
+  const { clientConfig } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'clientConfig',
+      message: 'Which MCP client you want to configure?',
+      choices: [
+        {
+          name: 'None / Manual Configuration',
+          value: 'manual',
+        },
+        {
+          name: 'Cursor',
+          value: 'cursor',
+        },
+        {
+          name: 'Claude Desktop',
+          value: 'claude-desktop',
+        },
+      ],
+    },
+  ]);
+
+  switch (clientConfig) {
+    case 'cursor':
+      await configureCursor(executableArgs);
+      break;
+    case 'claude-desktop':
+      await configureClaudeDesktop(executableArgs);
+      break;
+    case 'manual':
+    default:
+      console.info(
+        chalk.green('👀'),
+        'Use the following `npx` command for the configuration in your MCP client:',
+      );
+      console.info(`npx ${executableArgs.join(' ')}`);
+  }
+}
+
+export default async function config() {
+  let currentCredentials = await auth.getCredentials();
+  let shouldOverwrite = false;
+
+  if (currentCredentials) {
+    shouldOverwrite = await promptForOverwrite(currentCredentials.accountSid);
+  }
+
+  if (currentCredentials && !shouldOverwrite) {
+    console.info(chalk.green('✔'), 'Keeping existing credentials');
+  } else {
+    const authAnswers = await promptForCredentials();
+    await auth.setCredentials(
+      authAnswers.accountSid,
+      authAnswers.apiKey,
+      authAnswers.apiSecret,
+    );
+    currentCredentials = await auth.getCredentials();
+  }
+
+  const openAPIConfig = await promptForOpenAPIConfig();
+
+  const executableArgs = ['-y', '@twilio-alpha/mcp'];
+
+  if (openAPIConfig.tags) {
+    executableArgs.push('--tags', openAPIConfig.tags);
+  }
+
+  if (openAPIConfig.services) {
+    executableArgs.push('--services', openAPIConfig.services);
+  }
+
+  await configureClient(executableArgs);
+  console.info(chalk.green('✔'), 'All set!');
+}

packages/mcp/src/index.ts

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import { logger } from '@twilio-alpha/openapi-mcp-server';
 
-import init from '@app/init';
+import config from '@app/config';
 import main from '@app/main';
 
 const command = process.argv[2];
 
-if (command === 'init') {
-  init().catch((error) => {
-    logger.error(`Fatal error in init(): ${error}`);
+if (command === 'config') {
+  config().catch((error) => {
+    logger.error(`Fatal error in config(): ${error}`);
     process.exit(1);
   });
 } else {