agent-master-devsecops 0.0.0-stage → 5.1.0

package/scripts/mcp_server.js

@@ -0,0 +1,236 @@
+#!/usr/bin/env node
+/**
+ * scripts/mcp_server.js
+ * 
+ * Servidor MCP Nativo (Model Context Protocol) — Ponto de Entrada Canônico & CLI
+ * Compatível com a especificação JSON-RPC 2.0 / MCP 2024-11-05.
+ * 
+ * Atua como Fachada Canônica e Interface CLI de Alta Performance para o ecossistema
+ * agent-master-devsecops, delegando a execução ao dispatcher modular em ./mcp/server.js.
+ * 
+ * Suporta inicialização interativa stdio, seleção dinâmica de perfis (--profile),
+ * relatórios executivos (--report), auditoria de conformidade OASIS SARIF v2.1.0 (--sarif),
+ * consulta de versões (--version) e graceful shutdown.
+ * 
+ * Versão: 5.1.0 Enterprise
+ */
+
+'use strict';
+
+const { version: PKG_VERSION } = require('../package.json');
+const {
+  McpServer,
+  defaultServerInstance,
+  processMessage,
+  processMessageAsync,
+  startServer,
+  stopServer,
+  handleInitialize,
+  handleToolsList,
+  handleResourcesList,
+  handleResourceRead,
+  TOOLS,
+  RESOURCES,
+  TOOL_PROFILES,
+  getActiveTools,
+  setMcpProfile,
+  getActiveProfile,
+  auditToSarif,
+  formatReport,
+  PROTOCOL_VERSION,
+  JSONRPC_VERSION
+} = require('./mcp/server.js');
+
+/**
+ * Analisador funcional puro de argumentos de linha de comando.
+ * @param {string[]} argv 
+ * @returns {Record<string, any>}
+ */
+function parseArgs(argv = []) {
+  const args = Array.isArray(argv) ? argv : [];
+  const options = {
+    help: false,
+    version: false,
+    sarif: false,
+    report: false,
+    listTools: false,
+    listProfiles: false,
+    profile: null
+  };
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = String(args[i]);
+    if (arg === '--help' || arg === '-h') {
+      options.help = true;
+    } else if (arg === '--version' || arg === '-v') {
+      options.version = true;
+    } else if (arg === '--sarif') {
+      options.sarif = true;
+    } else if (arg === '--report') {
+      options.report = true;
+    } else if (arg === '--list-tools') {
+      options.listTools = true;
+    } else if (arg === '--list-profiles') {
+      options.listProfiles = true;
+    } else if (arg === '--profile' || arg === '-p') {
+      if (i + 1 < args.length && !args[i + 1].startsWith('-')) {
+        options.profile = String(args[i + 1]);
+        i++;
+      }
+    } else if (arg.startsWith('--profile=')) {
+      options.profile = arg.slice('--profile='.length);
+    }
+  }
+
+  return Object.freeze(options);
+}
+
+/**
+ * Formata o texto de ajuda do CLI.
+ * @returns {string}
+ */
+function formatHelpText() {
+  const profiles = Object.keys(TOOL_PROFILES).join(', ');
+  return [
+    `Servidor MCP Nativo — Agent Master DevSecOps v${PKG_VERSION}`,
+    `Protocolo MCP: ${PROTOCOL_VERSION} | JSON-RPC: ${JSONRPC_VERSION}`,
+    '',
+    'Uso:',
+    '  agent-master-mcp [opções]',
+    '  node scripts/mcp_server.js [opções]',
+    '',
+    'Opções:',
+    '  -p, --profile <nome>    Inicia o servidor com o perfil especificado',
+    `                          Perfis disponíveis: ${profiles}`,
+    '      --sarif             Executa auditoria e emite relatório OASIS SARIF v2.1.0',
+    '      --report            Emite relatório executivo em Markdown e finaliza',
+    '      --list-tools        Lista ferramentas ativas do perfil atual e finaliza',
+    '      --list-profiles     Lista todos os perfis disponíveis e finaliza',
+    '  -v, --version           Exibe a versão do servidor e do protocolo MCP',
+    '  -h, --help              Exibe esta ajuda operacional',
+    '',
+    'Exemplo de Configuração para IDEs (Claude Desktop / Cursor):',
+    '  {',
+    '    "mcpServers": {',
+    '      "agent-master": {',
+    '        "command": "node",',
+    '        "args": ["scripts/mcp_server.js", "--profile", "consolidated"]',
+    '      }',
+    '    }',
+    '  }'
+  ].join('\n');
+}
+
+/**
+ * Executor do ponto de entrada CLI com suporte a injeção de I/O.
+ * @param {string[]} argv 
+ * @param {object} io 
+ * @returns {number} Código de saída (0 para sucesso, > 0 para erro)
+ */
+function runCli(argv = process.argv.slice(2), io = {}) {
+  const stdout = io.stdout || process.stdout;
+  const stderr = io.stderr || process.stderr;
+
+  const options = parseArgs(argv);
+
+  if (options.help) {
+    stdout.write(formatHelpText() + '\n');
+    return 0;
+  }
+
+  if (options.version) {
+    stdout.write(`agent-master-devsecops v${PKG_VERSION} (MCP Protocol ${PROTOCOL_VERSION})\n`);
+    return 0;
+  }
+
+  if (options.sarif) {
+    const sarif = auditToSarif();
+    stdout.write(JSON.stringify(sarif, null, 2) + '\n');
+    return 0;
+  }
+
+  if (options.report) {
+    stdout.write(formatReport() + '\n');
+    return 0;
+  }
+
+  if (options.listProfiles) {
+    const list = Object.entries(TOOL_PROFILES)
+      .map(([name, tools]) => `  - ${name.padEnd(16)}: ${tools.length} ferramentas`)
+      .join('\n');
+    stdout.write(`Perfis de Ferramentas Disponíveis:\n${list}\n`);
+    return 0;
+  }
+
+  if (options.profile) {
+    const result = setMcpProfile(options.profile);
+    if (!result || !result.success) {
+      stderr.write(`[AVISO] Perfil desconhecido: "${options.profile}". Mantido perfil "${getActiveProfile()}".\n`);
+    }
+  }
+
+  if (options.listTools) {
+    const active = getActiveTools();
+    const list = active.map(t => `  - ${t.name.padEnd(30)}: ${t.description.slice(0, 60)}...`).join('\n');
+    stdout.write(`Ferramentas Ativas (Perfil: ${getActiveProfile()}, Total: ${active.length}):\n${list}\n`);
+    return 0;
+  }
+
+  // Em modo teste, não inicia listener bloqueante
+  if (io.testMode) {
+    return 0;
+  }
+
+  // Configura graceful shutdown no processo real
+  const cleanup = () => {
+    stopServer();
+    process.exit(0);
+  };
+  process.once('SIGINT', cleanup);
+  process.once('SIGTERM', cleanup);
+
+  startServer();
+  return 0;
+}
+
+if (require.main === module) {
+  runCli();
+}
+
+module.exports = {
+  // Fachada Canônica da Classe e Instância
+  McpServer,
+  defaultServerInstance,
+
+  // Funções de Despacho e Ciclo de Vida
+  processMessage,
+  processMessageAsync,
+  startServer,
+  stopServer,
+  handleInitialize,
+  handleToolsList,
+  handleResourcesList,
+  handleResourceRead,
+
+  // Catálogos e Perfis
+  TOOLS,
+  RESOURCES,
+  TOOL_PROFILES,
+  getActiveTools,
+  setMcpProfile,
+  getActiveProfile,
+
+  // Auditoria e Relatórios
+  auditToSarif,
+  formatReport,
+
+  // Utilitários CLI
+  parseArgs,
+  formatHelpText,
+  runCli,
+
+  // Constantes de Protocolo
+  PROTOCOL_VERSION,
+  JSONRPC_VERSION,
+  PKG_VERSION
+};