@edilsonfjdev/mcp-setup 0.1.0

package/dist/validate-6RKOV7JG.js

@@ -0,0 +1,167 @@
+import {
+  getRequiredVars,
+  loadEnv,
+  validateAllCredentials,
+  validatePresence
+} from "./chunk-JNVJQZTK.js";
+import {
+  logger
+} from "./chunk-Q36CDQK6.js";
+
+// src/validation/health-check.ts
+async function checkMcp(mcpName, env) {
+  const startTime = Date.now();
+  try {
+    switch (mcpName) {
+      case "github": {
+        const token = env.GITHUB_TOKEN;
+        if (!token) return { mcpName, status: "skip", message: "Token n\xE3o configurado" };
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 5e3);
+        const res = await fetch("https://api.github.com/user", {
+          headers: { Authorization: `Bearer ${token}` },
+          signal: controller.signal
+        });
+        clearTimeout(timeout);
+        if (res.ok) return { mcpName, status: "ok", message: "Autenticado com sucesso", durationMs: Date.now() - startTime };
+        return { mcpName, status: "fail", message: `HTTP ${res.status}: ${res.statusText}`, durationMs: Date.now() - startTime };
+      }
+      case "hetzner": {
+        const token = env.HETZNER_API_TOKEN;
+        if (!token) return { mcpName, status: "skip", message: "Token n\xE3o configurado" };
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 5e3);
+        const res = await fetch("https://api.hetzner.cloud/v1/servers", {
+          headers: { Authorization: `Bearer ${token}` },
+          signal: controller.signal
+        });
+        clearTimeout(timeout);
+        if (res.ok) return { mcpName, status: "ok", message: "Autenticado com sucesso", durationMs: Date.now() - startTime };
+        return { mcpName, status: "fail", message: `HTTP ${res.status}: ${res.statusText}`, durationMs: Date.now() - startTime };
+      }
+      case "coolify": {
+        const url = env.COOLIFY_BASE_URL;
+        const token = env.COOLIFY_ACCESS_TOKEN;
+        if (!url || !token) return { mcpName, status: "skip", message: "URL ou token n\xE3o configurado" };
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 5e3);
+        const res = await fetch(`${url}/api/v1/healthcheck`, {
+          headers: { Authorization: `Bearer ${token}` },
+          signal: controller.signal
+        });
+        clearTimeout(timeout);
+        if (res.ok) return { mcpName, status: "ok", message: "Inst\xE2ncia acess\xEDvel", durationMs: Date.now() - startTime };
+        return { mcpName, status: "fail", message: `HTTP ${res.status}`, durationMs: Date.now() - startTime };
+      }
+      case "figma":
+      case "linear":
+      case "slack":
+      case "clickup":
+      case "sentry":
+        return { mcpName, status: "skip", message: "OAuth \u2014 configurar ap\xF3s instala\xE7\xE3o" };
+      case "context7":
+      case "n8n-docs":
+      case "semgrep":
+      case "playwright":
+        return { mcpName, status: "ok", message: "Sem autentica\xE7\xE3o necess\xE1ria" };
+      default:
+        return { mcpName, status: "skip", message: "Health check n\xE3o dispon\xEDvel" };
+    }
+  } catch (error) {
+    if (error.name === "AbortError") {
+      return { mcpName, status: "timeout", message: "Timeout (5s)", durationMs: Date.now() - startTime };
+    }
+    return { mcpName, status: "fail", message: error.message, durationMs: Date.now() - startTime };
+  }
+}
+async function checkAllHealth(mcpNames, env) {
+  const results = await Promise.allSettled(
+    mcpNames.map((name) => checkMcp(name, env))
+  );
+  return results.map((result, i) => {
+    if (result.status === "fulfilled") return result.value;
+    return { mcpName: mcpNames[i], status: "fail", message: result.reason?.message || "Erro desconhecido" };
+  });
+}
+
+// src/commands/validate.ts
+import chalk from "chalk";
+async function validateCommand(options) {
+  logger.info("Validando configura\xE7\xE3o do ambiente...\n");
+  const envResult = loadEnv();
+  if (!envResult.success) {
+    logger.error(envResult.error || "Falha ao carregar .env");
+    process.exit(1);
+  }
+  logger.success(`Arquivo .env carregado: ${envResult.path}`);
+  const templates = ["minimal", "base", "saas", "agents", "full"];
+  console.log("");
+  logger.info("Valida\xE7\xE3o de credenciais por template:\n");
+  for (const template of templates) {
+    const required = getRequiredVars(template);
+    const presence = validatePresence(envResult.vars, required);
+    const validations = validateAllCredentials(template, envResult.vars);
+    const formatFailures = validations.filter((v) => !v.valid);
+    const presenceIcon = presence.valid ? chalk.green("\u2713") : chalk.red("\u2717");
+    const formatIcon = formatFailures.length === 0 ? chalk.green("\u2713") : chalk.yellow("!");
+    console.log(`  ${template.padEnd(10)} Presen\xE7a: ${presenceIcon} (${presence.present.length}/${required.length})  Formato: ${formatIcon}`);
+    if (presence.missing.length > 0) {
+      for (const m of presence.missing) {
+        console.log(chalk.red(`    \u2717 ${m.name} \u2014 ${m.description} (${m.mcpName})`));
+      }
+    }
+    if (formatFailures.length > 0) {
+      for (const f of formatFailures) {
+        if (!presence.missing.some((m) => m.name === f.variable)) {
+          console.log(chalk.yellow(`    ! ${f.variable} \u2014 ${f.error}`));
+        }
+      }
+    }
+  }
+  if (options.health) {
+    console.log("");
+    const spinner = logger.spinner("Executando health check...");
+    const allMcps = [
+      "github",
+      "context7",
+      "figma",
+      "stitch",
+      "linear",
+      "slack",
+      "clickup",
+      "hetzner",
+      "coolify",
+      "n8n-docs",
+      "semgrep",
+      "sentry",
+      "playwright"
+    ];
+    const results = await checkAllHealth(allMcps, envResult.vars);
+    spinner.stop();
+    renderHealthReport(results);
+  }
+  console.log("");
+  logger.success("Valida\xE7\xE3o conclu\xEDda");
+}
+function renderHealthReport(results) {
+  logger.info("Health Check:\n");
+  const statusIcon = {
+    ok: chalk.green("\u2713"),
+    fail: chalk.red("\u2717"),
+    timeout: chalk.yellow("\u23F1"),
+    skip: chalk.gray("\u2014")
+  };
+  for (const r of results) {
+    const icon = statusIcon[r.status];
+    const duration = r.durationMs ? chalk.gray(` (${r.durationMs}ms)`) : "";
+    console.log(`  ${icon} ${r.mcpName.padEnd(16)} ${r.message}${duration}`);
+  }
+  const ok = results.filter((r) => r.status === "ok").length;
+  const fail = results.filter((r) => r.status === "fail").length;
+  const skip = results.filter((r) => r.status === "skip").length;
+  console.log("");
+  console.log(`  ${ok} OK | ${fail} falhas | ${skip} ignorados`);
+}
+export {
+  validateCommand
+};

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@edilsonfjdev/mcp-setup",
+  "version": "0.1.0",
+  "description": "Solução padronizada para instalação e configuração de MCP Servers no Claude Code",
+  "author": {
+    "name": "Edilson de Freitas Júnior",
+    "email": "edilson.desenvolved@gmail.com"
+  },
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "mcp-setup": "./bin/mcp-setup.js"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "bin/",
+    "dist/",
+    "templates/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsup",
+    "test": "vitest",
+    "test:unit": "vitest run tests/unit/",
+    "test:integration": "vitest run tests/integration/",
+    "test:smoke": "vitest run tests/smoke/",
+    "test:ci": "vitest run --coverage",
+    "test:watch": "vitest --watch",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "npm run lint && npm run test:ci && npm run build"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/edilsonfj/mcp-setup.git"
+  },
+  "homepage": "https://github.com/edilsonfj/mcp-setup#readme",
+  "bugs": {
+    "url": "https://github.com/edilsonfj/mcp-setup/issues"
+  },
+  "keywords": [
+    "mcp",
+    "claude-code",
+    "model-context-protocol",
+    "cli",
+    "setup",
+    "configuration",
+    "anthropic",
+    "ai"
+  ],
+  "dependencies": {
+    "commander": "^12.1.0",
+    "chalk": "^5.3.0",
+    "ora": "^8.1.0",
+    "dotenv": "^16.4.5",
+    "zod": "^3.24.2",
+    "deepmerge-ts": "^7.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0",
+    "tsup": "^8.3.0",
+    "tsx": "^4.19.0",
+    "vitest": "^2.1.0",
+    "@vitest/coverage-v8": "^2.1.0",
+    "@types/node": "^22.0.0"
+  }
+}

package/templates/mcps/clickup.json

@@ -0,0 +1,35 @@
+{
+  "name": "clickup",
+  "displayName": "ClickUp",
+  "category": "gestão",
+  "auth": {
+    "type": "oauth",
+    "envVar": null,
+    "required": false,
+    "headless": {
+      "type": "api-key",
+      "envVar": "CLICKUP_API_KEY",
+      "required": true
+    }
+  },
+  "config": {
+    "type": "http",
+    "url": "https://mcp.clickup.com/mcp"
+  },
+  "headlessConfig": {
+    "type": "stdio",
+    "command": "npx",
+    "args": ["-y", "@taazkareem/clickup-mcp-server@latest"],
+    "env": {
+      "CLICKUP_API_KEY": "${CLICKUP_API_KEY}",
+      "CLICKUP_TEAM_ID": "${CLICKUP_TEAM_ID}"
+    }
+  },
+  "metadata": {
+    "description": "Tarefas, time tracking e documentos",
+    "docsUrl": "https://developer.clickup.com",
+    "credentialUrl": "https://app.clickup.com/settings/apps",
+    "credentialInstructions": "Settings > Apps > API Token (pk_...). Team ID na URL do workspace.",
+    "version": "1.0.0"
+  }
+}

package/templates/mcps/context7.json

@@ -0,0 +1,19 @@
+{
+  "name": "context7",
+  "displayName": "Context7",
+  "category": "documentação",
+  "auth": {
+    "type": "none",
+    "envVar": null,
+    "required": false
+  },
+  "config": {
+    "type": "http",
+    "url": "https://mcp.context7.com/mcp"
+  },
+  "metadata": {
+    "description": "Documentação atualizada de bibliotecas e frameworks",
+    "docsUrl": "https://context7.com",
+    "version": "1.0.0"
+  }
+}

package/templates/mcps/coolify.json

@@ -0,0 +1,24 @@
+{
+  "name": "coolify",
+  "displayName": "Coolify",
+  "category": "infraestrutura",
+  "auth": {
+    "type": "api-key",
+    "envVar": "COOLIFY_ACCESS_TOKEN",
+    "required": true
+  },
+  "config": {
+    "type": "stdio",
+    "command": "npx",
+    "args": ["-y", "@masonator/coolify-mcp@latest"],
+    "env": {
+      "COOLIFY_BASE_URL": "${COOLIFY_BASE_URL}",
+      "COOLIFY_ACCESS_TOKEN": "${COOLIFY_ACCESS_TOKEN}"
+    }
+  },
+  "metadata": {
+    "description": "Deploy, apps, bancos de dados, logs e variáveis de ambiente",
+    "docsUrl": "https://coolify.io/docs",
+    "version": "1.0.0"
+  }
+}

package/templates/mcps/figma.json

@@ -0,0 +1,19 @@
+{
+  "name": "figma",
+  "displayName": "Figma",
+  "category": "design",
+  "auth": {
+    "type": "oauth",
+    "envVar": null,
+    "required": false
+  },
+  "config": {
+    "type": "http",
+    "url": "https://mcp.figma.com/mcp"
+  },
+  "metadata": {
+    "description": "Design-to-code, tokens de design e captura de UI",
+    "docsUrl": "https://www.figma.com/developers",
+    "version": "1.0.0"
+  }
+}

package/templates/mcps/github.json

@@ -0,0 +1,22 @@
+{
+  "name": "github",
+  "displayName": "GitHub",
+  "category": "desenvolvimento",
+  "auth": {
+    "type": "bearer",
+    "envVar": "GITHUB_TOKEN",
+    "required": true
+  },
+  "config": {
+    "type": "http",
+    "url": "https://api.githubcopilot.com/mcp",
+    "headers": {
+      "Authorization": "Bearer ${GITHUB_TOKEN}"
+    }
+  },
+  "metadata": {
+    "description": "Repositórios, PRs, issues e busca de código",
+    "docsUrl": "https://docs.github.com",
+    "version": "1.0.0"
+  }
+}

package/templates/mcps/hetzner.json

@@ -0,0 +1,23 @@
+{
+  "name": "hetzner",
+  "displayName": "Hetzner",
+  "category": "infraestrutura",
+  "auth": {
+    "type": "api-key",
+    "envVar": "HETZNER_API_TOKEN",
+    "required": true
+  },
+  "config": {
+    "type": "stdio",
+    "command": "npx",
+    "args": ["-y", "hetzner-mcp-server"],
+    "env": {
+      "HETZNER_API_TOKEN": "${HETZNER_API_TOKEN}"
+    }
+  },
+  "metadata": {
+    "description": "VPS, firewalls, chaves SSH e volumes",
+    "docsUrl": "https://docs.hetzner.com",
+    "version": "1.0.0"
+  }
+}

package/templates/mcps/linear.json

@@ -0,0 +1,33 @@
+{
+  "name": "linear",
+  "displayName": "Linear",
+  "category": "gestão",
+  "auth": {
+    "type": "oauth",
+    "envVar": null,
+    "required": false,
+    "headless": {
+      "type": "api-key",
+      "envVar": "LINEAR_API_KEY",
+      "required": true
+    }
+  },
+  "config": {
+    "type": "http",
+    "url": "https://mcp.linear.app/mcp"
+  },
+  "headlessConfig": {
+    "type": "http",
+    "url": "https://mcp.linear.app/mcp",
+    "headers": {
+      "Authorization": "${LINEAR_API_KEY}"
+    }
+  },
+  "metadata": {
+    "description": "Issues, projetos e sprints",
+    "docsUrl": "https://linear.app/developers",
+    "credentialUrl": "https://linear.app/settings/account/security",
+    "credentialInstructions": "Settings > Account > Security & Access > Personal API Keys",
+    "version": "1.0.0"
+  }
+}

package/templates/mcps/n8n-docs.json

@@ -0,0 +1,20 @@
+{
+  "name": "n8n-docs",
+  "displayName": "N8N Docs",
+  "category": "workflow",
+  "auth": {
+    "type": "none",
+    "envVar": null,
+    "required": false
+  },
+  "config": {
+    "type": "stdio",
+    "command": "npx",
+    "args": ["-y", "n8n-mcp"]
+  },
+  "metadata": {
+    "description": "Referência de 1200+ nodes do N8N",
+    "docsUrl": "https://docs.n8n.io",
+    "version": "1.0.0"
+  }
+}

package/templates/mcps/n8n-instance.json

@@ -0,0 +1,22 @@
+{
+  "name": "n8n-instance",
+  "displayName": "N8N Instance",
+  "category": "workflow",
+  "auth": {
+    "type": "bearer",
+    "envVar": "N8N_MCP_TOKEN",
+    "required": true
+  },
+  "config": {
+    "type": "http",
+    "url": "${N8N_URL}/mcp",
+    "headers": {
+      "Authorization": "Bearer ${N8N_MCP_TOKEN}"
+    }
+  },
+  "metadata": {
+    "description": "Acesso direto a workflows da instância N8N",
+    "docsUrl": "https://docs.n8n.io",
+    "version": "1.0.0"
+  }
+}

package/templates/mcps/playwright.json

@@ -0,0 +1,20 @@
+{
+  "name": "playwright",
+  "displayName": "Playwright",
+  "category": "testes",
+  "auth": {
+    "type": "none",
+    "envVar": null,
+    "required": false
+  },
+  "config": {
+    "type": "stdio",
+    "command": "npx",
+    "args": ["-y", "@anthropic/playwright-mcp"]
+  },
+  "metadata": {
+    "description": "Testes E2E e automação de browser",
+    "docsUrl": "https://playwright.dev/docs",
+    "version": "1.0.0"
+  }
+}

package/templates/mcps/postgres.json

@@ -0,0 +1,20 @@
+{
+  "name": "postgres",
+  "displayName": "PostgreSQL",
+  "category": "banco-de-dados",
+  "auth": {
+    "type": "dsn",
+    "envVar": "DATABASE_URL",
+    "required": true
+  },
+  "config": {
+    "type": "stdio",
+    "command": "npx",
+    "args": ["-y", "@bytebase/dbhub", "--dsn", "${DATABASE_URL}"]
+  },
+  "metadata": {
+    "description": "Consultas diretas ao banco de dados PostgreSQL",
+    "docsUrl": "https://www.postgresql.org/docs",
+    "version": "1.0.0"
+  }
+}

package/templates/mcps/semgrep.json

@@ -0,0 +1,19 @@
+{
+  "name": "semgrep",
+  "displayName": "Semgrep",
+  "category": "segurança",
+  "auth": {
+    "type": "none",
+    "envVar": null,
+    "required": false
+  },
+  "config": {
+    "type": "http",
+    "url": "https://mcp.semgrep.ai/mcp"
+  },
+  "metadata": {
+    "description": "SAST e análise estática de código",
+    "docsUrl": "https://semgrep.dev/docs",
+    "version": "1.0.0"
+  }
+}

package/templates/mcps/sentry.json

@@ -0,0 +1,34 @@
+{
+  "name": "sentry",
+  "displayName": "Sentry",
+  "category": "monitoramento",
+  "auth": {
+    "type": "oauth",
+    "envVar": null,
+    "required": false,
+    "headless": {
+      "type": "api-key",
+      "envVar": "SENTRY_ACCESS_TOKEN",
+      "required": true
+    }
+  },
+  "config": {
+    "type": "http",
+    "url": "https://mcp.sentry.dev/mcp"
+  },
+  "headlessConfig": {
+    "type": "stdio",
+    "command": "npx",
+    "args": ["-y", "@sentry/mcp-server@latest"],
+    "env": {
+      "SENTRY_ACCESS_TOKEN": "${SENTRY_ACCESS_TOKEN}"
+    }
+  },
+  "metadata": {
+    "description": "Erros, stack traces e performance",
+    "docsUrl": "https://docs.sentry.io",
+    "credentialUrl": "https://sentry.io/settings/account/api/auth-tokens/",
+    "credentialInstructions": "sentry.io > Settings > Auth Tokens > Create New Token",
+    "version": "1.0.0"
+  }
+}

package/templates/mcps/slack.json

@@ -0,0 +1,34 @@
+{
+  "name": "slack",
+  "displayName": "Slack",
+  "category": "comunicação",
+  "auth": {
+    "type": "oauth",
+    "envVar": null,
+    "required": false,
+    "headless": {
+      "type": "api-key",
+      "envVar": "SLACK_BOT_TOKEN",
+      "required": true
+    }
+  },
+  "config": {
+    "type": "http",
+    "url": "https://mcp.slack.com/mcp"
+  },
+  "headlessConfig": {
+    "type": "stdio",
+    "command": "npx",
+    "args": ["-y", "slack-mcp-server@latest", "--transport", "stdio"],
+    "env": {
+      "SLACK_BOT_TOKEN": "${SLACK_BOT_TOKEN}"
+    }
+  },
+  "metadata": {
+    "description": "Mensagens, busca e canais",
+    "docsUrl": "https://api.slack.com",
+    "credentialUrl": "https://api.slack.com/apps",
+    "credentialInstructions": "api.slack.com/apps > Create App > OAuth & Permissions > Bot Token Scopes > Install > Copy Bot Token (xoxb-...)",
+    "version": "1.0.0"
+  }
+}

package/templates/mcps/stitch.json

@@ -0,0 +1,22 @@
+{
+  "name": "stitch",
+  "displayName": "Stitch",
+  "category": "design",
+  "auth": {
+    "type": "api-key",
+    "envVar": "STITCH_API_KEY",
+    "required": true
+  },
+  "config": {
+    "type": "http",
+    "url": "https://stitch.googleapis.com/mcp",
+    "headers": {
+      "X-Goog-Api-Key": "${STITCH_API_KEY}"
+    }
+  },
+  "metadata": {
+    "description": "Geração de UI via texto (Google)",
+    "docsUrl": "https://stitch.withgoogle.com",
+    "version": "1.0.0"
+  }
+}

package/templates/profiles/agents.json

@@ -0,0 +1,7 @@
+{
+  "name": "agents",
+  "displayName": "Agents",
+  "description": "Projetos com agentes IA, workflows N8N e automação",
+  "mcps": ["github", "context7", "figma", "stitch", "linear", "slack", "clickup", "coolify", "semgrep", "postgres", "sentry", "hetzner", "n8n-docs", "n8n-instance", "playwright"],
+  "version": "1.0.0"
+}

package/templates/profiles/base.json

@@ -0,0 +1,7 @@
+{
+  "name": "base",
+  "displayName": "Base",
+  "description": "Projetos padrão com PM, design e deploy",
+  "mcps": ["github", "context7", "figma", "stitch", "linear", "slack", "clickup", "coolify", "semgrep"],
+  "version": "1.0.0"
+}

package/templates/profiles/full.json

@@ -0,0 +1,7 @@
+{
+  "name": "full",
+  "displayName": "Full",
+  "description": "Setup global completo com todos os MCPs de escopo user",
+  "mcps": ["github", "context7", "figma", "stitch", "linear", "slack", "clickup", "hetzner", "coolify", "n8n-docs", "semgrep", "sentry", "playwright"],
+  "version": "1.0.0"
+}

package/templates/profiles/headless.json

@@ -0,0 +1,20 @@
+{
+  "name": "headless",
+  "displayName": "Headless",
+  "description": "Servidores e VPS sem browser — todos os MCPs via token ou API key (exceto Figma)",
+  "mcps": [
+    "github",
+    "context7",
+    "stitch",
+    "linear",
+    "slack",
+    "clickup",
+    "hetzner",
+    "coolify",
+    "n8n-docs",
+    "semgrep",
+    "sentry",
+    "playwright"
+  ],
+  "version": "1.0.0"
+}