bflabs-mcp 1.0.0

package/bin/bflabs-mcp.js

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+import { select, input } from "@inquirer/prompts";
+import chalk from "chalk";
+import { provision, TOOLS } from "../lib/installer.js";
+import { writeMcpConfig } from "../lib/config-writer.js";
+import { writeSkill } from "../lib/skill-writer.js";
+
+console.log();
+console.log(chalk.bold.cyan("  ╔══════════════════════════════════════╗"));
+console.log(chalk.bold.cyan("  ║            BF MCP  v1.0.0            ║"));
+console.log(chalk.bold.cyan("  ╚══════════════════════════════════════╝"));
+console.log();
+
+try {
+  const tool = await select({
+    message: "Which tool do you want to install?",
+    choices: TOOLS,
+  });
+
+  const email = await input({
+    message: "Enter your email:",
+    validate: (v) => v.includes("@") || "Enter a valid email",
+  });
+
+  process.stdout.write(chalk.dim("  ◌ Authenticating..."));
+
+  let data;
+  try {
+    data = await provision(email, tool);
+    process.stdout.write("\r" + chalk.green("  ✓ Authenticated") + "           \n");
+  } catch (err) {
+    process.stdout.write("\r" + chalk.red("  ✗ " + err.message) + "\n");
+    process.exit(1);
+  }
+
+  // Write MCP config
+  const serverName = `bflabs-${tool}`;
+  const written = writeMcpConfig(serverName, data.mcp_url, data.api_key);
+  console.log(chalk.green("  ✓ MCP configured") + chalk.dim(` → ${written[0] || "~/.claude"}`));
+
+  // Write skill
+  const skillPath = writeSkill(tool);
+  console.log(chalk.green("  ✓ Skill installed") + chalk.dim(` → ${skillPath}`));
+
+  console.log();
+  console.log(chalk.bold("  Done! Restart Claude to activate."));
+  console.log();
+  console.log(
+    chalk.dim("  MCP:   ") +
+    chalk.cyan(serverName) +
+    chalk.dim(" → ") +
+    chalk.underline(data.mcp_url)
+  );
+  console.log(chalk.dim("  User:  ") + data.user_name + chalk.dim(` (${data.role})`));
+  console.log();
+} catch (err) {
+  if (err.name === "ExitPromptError") {
+    console.log(chalk.dim("\n  Cancelled."));
+    process.exit(0);
+  }
+  console.error(chalk.red("  Error: " + err.message));
+  process.exit(1);
+}

package/lib/config-writer.js

@@ -0,0 +1,75 @@
+import os from "os";
+import path from "path";
+import fs from "fs";
+
+function getClaudeConfigPaths() {
+  const platform = process.platform;
+  const home = os.homedir();
+
+  if (platform === "darwin") {
+    return [
+      path.join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json"),
+    ];
+  } else if (platform === "win32") {
+    return [
+      path.join(process.env.APPDATA || "", "Claude", "claude_desktop_config.json"),
+    ];
+  } else {
+    // Linux — Claude Desktop e Claude Code
+    return [
+      path.join(home, ".config", "Claude", "claude_desktop_config.json"),
+      path.join(home, ".claude.json"),
+    ];
+  }
+}
+
+export function writeMcpConfig(serverName, mcpUrl, apiKey) {
+  const configPaths = getClaudeConfigPaths();
+  const written = [];
+
+  for (const configPath of configPaths) {
+    try {
+      let config = {};
+      if (fs.existsSync(configPath)) {
+        const raw = fs.readFileSync(configPath, "utf-8");
+        config = JSON.parse(raw);
+      }
+
+      if (!config.mcpServers) config.mcpServers = {};
+
+      config.mcpServers[serverName] = {
+        url: mcpUrl,
+        headers: {
+          Authorization: `Bearer ${apiKey}`,
+        },
+      };
+
+      fs.mkdirSync(path.dirname(configPath), { recursive: true });
+      fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+      written.push(configPath);
+    } catch {
+      // skip if not writable
+    }
+  }
+
+  // Also write to ~/.claude/mcp_servers/ for Claude Code
+  const claudeCodeMcp = path.join(os.homedir(), ".claude", "mcp_servers.json");
+  try {
+    let config = {};
+    if (fs.existsSync(claudeCodeMcp)) {
+      config = JSON.parse(fs.readFileSync(claudeCodeMcp, "utf-8"));
+    }
+    if (!config.mcpServers) config.mcpServers = {};
+    config.mcpServers[serverName] = {
+      url: mcpUrl,
+      headers: { Authorization: `Bearer ${apiKey}` },
+    };
+    fs.mkdirSync(path.dirname(claudeCodeMcp), { recursive: true });
+    fs.writeFileSync(claudeCodeMcp, JSON.stringify(config, null, 2));
+    written.push(claudeCodeMcp);
+  } catch {
+    // skip
+  }
+
+  return written;
+}

package/lib/installer.js

@@ -0,0 +1,33 @@
+import os from "os";
+import path from "path";
+import fs from "fs";
+
+const API_BASE = "https://adsmanager.bflabs.com.br/api/v1";
+
+export const TOOLS = [
+  {
+    value: "ads-manager",
+    name: "ads-manager     — Meta Ads: campanhas, ad sets, ads, criativos, insights, audiences, planos, relatórios automáticos, cohort engine, ad copies (112 tools)",
+  },
+  {
+    value: "catalog-manager",
+    name: "catalog-manager — Meta Commerce: produtos, variantes em escala, Product Sets, bulk create (catálogo integrado ao ads-manager)",
+  },
+];
+
+export async function provision(email, tool) {
+  const res = await fetch(`${API_BASE}/installer/provision`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ email, tool }),
+  });
+
+  if (!res.ok) {
+    const body = await res.json().catch(() => ({}));
+    throw new Error(body.detail || body.message || `HTTP ${res.status}`);
+  }
+
+  const json = await res.json();
+  if (!json.success) throw new Error(json.error || "Provision failed");
+  return json.data;
+}

package/lib/skill-writer.js

@@ -0,0 +1,97 @@
+import os from "os";
+import path from "path";
+import fs from "fs";
+
+const SKILL_CONTENTS = {
+  "ads-manager": `---
+name: ads-manager
+description: Gerencia Meta Ads (Facebook/Instagram) via MCP server. Use quando o usuário pedir para criar campanhas, analisar resultados, gerenciar ativos (páginas, audiences, pixels, catálogos) ou operar contas de anúncio.
+license: proprietary
+metadata:
+  version: 1.0.0
+  author: BF Labs
+  tags:
+    - meta-ads
+    - facebook-ads
+    - mcp
+    - bf-labs
+  platforms:
+    - Claude
+---
+
+# Ads Manager — BF Labs
+
+Acesse todas as operações de Meta Ads via MCP server \`bflabs-ads-manager\`.
+
+## MCP Server
+
+Conectado via \`bflabs-ads-manager\` com suas credenciais pessoais.
+
+## Quando usar
+
+- Criar, pausar, ativar ou duplicar campanhas/ad sets/ads
+- Analisar performance (ROAS, CPL, CTR, spend)
+- Gerenciar criativos e fazer upload de imagens/vídeos
+- Gerar relatório de todas as contas
+- Criar Custom Audiences e Lookalikes
+- Planejar campanha completa e executar via agente
+
+## Começar
+
+Sempre inicie com:
+\`\`\`
+context_list_clients()       → clientes disponíveis para você
+context_get_client("nome")   → assets completos do cliente
+\`\`\`
+`,
+  "catalog-manager": `---
+name: catalog-manager
+description: Gerencia catálogos de produtos Meta (Commerce Manager) via MCP. Use quando o usuário pedir para criar produtos, variantes, conjuntos de produtos (Product Sets) ou executar criação em massa.
+license: proprietary
+metadata:
+  version: 1.0.0
+  author: BF Labs
+  tags:
+    - meta-catalog
+    - commerce-manager
+    - mcp
+    - bf-labs
+  platforms:
+    - Claude
+---
+
+# Catalog Manager — BF Labs
+
+Operação de catálogos de produtos Meta via Commerce Manager.
+
+## Fluxo principal
+
+1 produto → 4 variantes idênticas → 1 Product Set automático
+
+## Quando usar
+
+- Criar produto novo no catálogo de um cliente
+- Criar variantes idênticas (fluxo de escala)
+- Criar Product Set automaticamente
+- Listar e atualizar produtos existentes
+
+## Começar
+
+\`\`\`
+context_get_client("nome-do-cliente")  → business_id
+catalog_list(business_id)              → catalog_id
+\`\`\`
+`,
+};
+
+export function writeSkill(toolName) {
+  const skillContent = SKILL_CONTENTS[toolName];
+  if (!skillContent) throw new Error(`No skill content for: ${toolName}`);
+
+  const skillDir = path.join(os.homedir(), ".claude", "skills", toolName);
+  const skillPath = path.join(skillDir, "SKILL.md");
+
+  fs.mkdirSync(skillDir, { recursive: true });
+  fs.writeFileSync(skillPath, skillContent);
+  return skillPath;
+}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "bflabs-mcp",
+  "version": "1.0.0",
+  "description": "BF MCP — instala o MCP server e skill do ads-manager e catalog-manager em Claude Desktop/Code",
+  "bin": {
+    "bflabs-mcp": "./bin/bflabs-mcp.js"
+  },
+  "main": "./lib/installer.js",
+  "type": "module",
+  "files": [
+    "bin/",
+    "lib/"
+  ],
+  "dependencies": {
+    "@inquirer/prompts": "^7.0.0",
+    "chalk": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": ["mcp", "claude", "bf-labs", "meta-ads", "installer"],
+  "author": "BF Labs <brunoguerrafalcao@gmail.com>",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/BFLabsAI/bflabs-mcp"
+  }
+}