aibrain-mcp 0.1.0

package/README.md

@@ -0,0 +1,100 @@
+# AI Brain MCP
+
+**3 IA debattent. 1 reponse.** Claude, GPT et Gemini collaborent pour resoudre vos problemes complexes.
+
+## Installation rapide
+
+```bash
+# 1. Installer le package
+npm install -g aibrain-mcp
+
+# 2. Configurer Claude Code
+aibrain-setup --api-key VOTRE_CLE_API
+
+# 3. Redemarrer Claude Code
+```
+
+Obtenez votre cle API sur [aibrain.dev/dashboard](https://aibrain.dev/dashboard)
+
+## Utilisation avec npx (sans installation)
+
+```bash
+npx aibrain-mcp
+```
+
+## Outils disponibles
+
+### `debate(question)`
+Lance un debat complet entre 3 IA :
+1. Chaque IA analyse la question
+2. Les IA critiquent mutuellement leurs reponses
+3. Une synthese finale consolidee est produite
+
+### `quick_review(question)`
+Analyse rapide par 3 IA sans debat complet. Plus rapide mais moins approfondi.
+
+## Configuration manuelle
+
+### Claude Code (global)
+Ajoutez dans `~/.claude/.mcp.json` :
+```json
+{
+  "mcpServers": {
+    "aibrain": {
+      "command": "npx",
+      "args": ["-y", "aibrain-mcp"],
+      "env": {
+        "AIBRAIN_API_KEY": "votre_cle_api"
+      }
+    }
+  }
+}
+```
+
+### Claude Desktop
+Ajoutez dans votre `claude_desktop_config.json` :
+```json
+{
+  "mcpServers": {
+    "aibrain": {
+      "command": "npx",
+      "args": ["-y", "aibrain-mcp"],
+      "env": {
+        "AIBRAIN_API_KEY": "votre_cle_api"
+      }
+    }
+  }
+}
+```
+
+## Mode BYOK (Bring Your Own Keys)
+
+Si vous preferez utiliser vos propres cles API :
+```json
+{
+  "mcpServers": {
+    "aibrain": {
+      "command": "npx",
+      "args": ["-y", "aibrain-mcp"],
+      "env": {
+        "ANTHROPIC_API_KEY": "sk-ant-...",
+        "OPENAI_API_KEY": "sk-...",
+        "GOOGLE_API_KEY": "AIza..."
+      }
+    }
+  }
+}
+```
+
+## Plans
+
+| Plan | Debats/jour | Prix |
+|------|-------------|------|
+| Gratuit | 5 | 0 EUR |
+| Pro | 100 | 19 EUR/mois |
+| Team | Illimite | 49 EUR/mois |
+
+## Support
+
+- Site : [aibrain.dev](https://aibrain.dev)
+- Issues : [GitHub](https://github.com/aibrain-dev/aibrain-mcp/issues)

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+// ---------- Config ----------
+const API_BASE = process.env.AIBRAIN_API_URL || "https://aibrain-mcp-backend.vercel.app";
+const API_KEY = process.env.AIBRAIN_API_KEY || "";
+// BYOK mode — user brings their own keys, runs debate locally via the API
+const BYOK = !API_KEY && (!!process.env.ANTHROPIC_API_KEY ||
+    !!process.env.OPENAI_API_KEY ||
+    !!process.env.GOOGLE_API_KEY);
+async function callAPI(req) {
+    const headers = {
+        "Content-Type": "application/json",
+    };
+    if (API_KEY) {
+        headers["Authorization"] = `Bearer ${API_KEY}`;
+    }
+    // In BYOK mode, forward the user's own API keys
+    if (BYOK) {
+        if (process.env.ANTHROPIC_API_KEY)
+            headers["X-Anthropic-Key"] = process.env.ANTHROPIC_API_KEY;
+        if (process.env.OPENAI_API_KEY)
+            headers["X-OpenAI-Key"] = process.env.OPENAI_API_KEY;
+        if (process.env.GOOGLE_API_KEY)
+            headers["X-Google-Key"] = process.env.GOOGLE_API_KEY;
+    }
+    const endpoint = req.mode === "debate" ? "/v1/debate" : "/v1/quick-review";
+    const res = await fetch(`${API_BASE}${endpoint}`, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({ question: req.question }),
+    });
+    if (!res.ok) {
+        const error = await res.text();
+        throw new Error(`API error ${res.status}: ${error}`);
+    }
+    const data = (await res.json());
+    return data.result;
+}
+// ---------- MCP Server ----------
+const server = new McpServer({
+    name: "AI Brain MCP",
+    version: "0.1.0",
+});
+server.tool("debate", "Lance un débat complet entre 3 IA différentes (Claude, GPT, Gemini). " +
+    "Chaque IA analyse la question depuis sa perspective, critique les autres, " +
+    "puis une synthèse finale consolidée est produite. " +
+    "Utilise pour les questions complexes (architecture, code, sécurité).", { question: z.string().describe("La question ou le problème à résoudre") }, async ({ question }) => {
+    const result = await callAPI({ question, mode: "debate" });
+    return { content: [{ type: "text", text: result }] };
+});
+server.tool("quick_review", "Analyse rapide par 3 IA (Claude, GPT, Gemini) sans débat complet. " +
+    "Chaque IA donne son avis, puis synthèse directe. " +
+    "Plus rapide que debate() mais moins approfondi.", { question: z.string().describe("La question ou le problème à analyser") }, async ({ question }) => {
+    const result = await callAPI({ question, mode: "quick_review" });
+    return { content: [{ type: "text", text: result }] };
+});
+// ---------- Start ----------
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error("Fatal:", err);
+    process.exit(1);
+});

package/dist/setup.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * CLI setup for AI Brain MCP.
+ * Configures Claude Desktop or Claude Code to use the aibrain-mcp server.
+ */
+export {};

package/dist/setup.js

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+/**
+ * CLI setup for AI Brain MCP.
+ * Configures Claude Desktop or Claude Code to use the aibrain-mcp server.
+ */
+import { existsSync, readFileSync, writeFileSync, copyFileSync, mkdirSync } from "fs";
+import { join, dirname } from "path";
+import { homedir, platform } from "os";
+// ---------- Config paths ----------
+function getClaudeDesktopConfigPath() {
+    const home = homedir();
+    const paths = {
+        darwin: join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json"),
+        win32: join(home, "AppData", "Roaming", "Claude", "claude_desktop_config.json"),
+        linux: join(home, ".config", "Claude", "claude_desktop_config.json"),
+    };
+    const p = paths[platform()];
+    return p && existsSync(p) ? p : null;
+}
+function getClaudeCodeConfigPath() {
+    return join(homedir(), ".claude", ".mcp.json");
+}
+// ---------- MCP config entry ----------
+function getMcpEntry(apiKey) {
+    return {
+        command: "npx",
+        args: ["-y", "aibrain-mcp"],
+        env: {
+            AIBRAIN_API_KEY: apiKey,
+            AIBRAIN_API_URL: "https://aibrain-mcp-backend.vercel.app",
+        },
+    };
+}
+// ---------- Update config file ----------
+function updateConfig(configPath, apiKey) {
+    let config = {};
+    if (existsSync(configPath)) {
+        const raw = readFileSync(configPath, "utf-8");
+        try {
+            config = JSON.parse(raw);
+        }
+        catch {
+            console.error(`  Error: Could not parse ${configPath}`);
+            process.exit(1);
+        }
+        // Backup
+        const backupPath = configPath + ".backup";
+        copyFileSync(configPath, backupPath);
+        console.log(`  Backup: ${backupPath}`);
+    }
+    else {
+        // Create parent dir if needed
+        const dir = dirname(configPath);
+        mkdirSync(dir, { recursive: true });
+    }
+    const servers = config.mcpServers || {};
+    servers["aibrain"] = getMcpEntry(apiKey);
+    config.mcpServers = servers;
+    writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+}
+// ---------- Main ----------
+function main() {
+    const args = process.argv.slice(2);
+    if (args.includes("--help") || args.includes("-h")) {
+        console.log(`
+  AI Brain MCP - Setup
+
+  Usage:
+    aibrain-setup --api-key YOUR_KEY            Configure Claude Code (global)
+    aibrain-setup --api-key YOUR_KEY --desktop   Configure Claude Desktop
+    aibrain-setup --api-key YOUR_KEY --all       Configure both
+
+  Options:
+    --api-key KEY   Your AI Brain API key (from your dashboard)
+    --desktop       Configure Claude Desktop
+    --all           Configure both Claude Code and Claude Desktop
+    --help          Show this help
+`);
+        process.exit(0);
+    }
+    // Parse --api-key
+    const keyIdx = args.indexOf("--api-key");
+    if (keyIdx === -1 || !args[keyIdx + 1]) {
+        console.error("Error: --api-key is required.\n");
+        console.error("Usage: aibrain-setup --api-key YOUR_KEY");
+        console.error("Get your key at https://aibrainfront.vercel.app/dashboard");
+        process.exit(1);
+    }
+    const apiKey = args[keyIdx + 1];
+    // Validate API key format
+    if (!apiKey.startsWith("ab_live_") || apiKey.length < 20) {
+        console.error("Error: Invalid API key format.");
+        console.error("Keys start with 'ab_live_' and are 56 characters long.");
+        console.error("Get your key at https://aibrainfront.vercel.app/dashboard");
+        process.exit(1);
+    }
+    const configureDesktop = args.includes("--desktop") || args.includes("--all");
+    const configureCode = !args.includes("--desktop") || args.includes("--all");
+    console.log("\n  AI Brain MCP - Configuration\n");
+    // Claude Code (global config)
+    if (configureCode) {
+        const codePath = getClaudeCodeConfigPath();
+        updateConfig(codePath, apiKey);
+        console.log(`  Claude Code: configured (${codePath})`);
+    }
+    // Claude Desktop
+    if (configureDesktop) {
+        const desktopPath = getClaudeDesktopConfigPath();
+        if (desktopPath) {
+            updateConfig(desktopPath, apiKey);
+            console.log(`  Claude Desktop: configured (${desktopPath})`);
+        }
+        else {
+            console.log("  Claude Desktop: config not found (is it installed?)");
+        }
+    }
+    console.log(`
+  Done! Restart Claude to activate AI Brain MCP.
+
+  Tools available:
+    - debate(question)       Full multi-AI debate
+    - quick_review(question) Quick multi-perspective analysis
+
+  Dashboard: https://aibrainfront.vercel.app/dashboard
+`);
+}
+main();

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "aibrain-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for multi-AI debate — Claude, GPT & Gemini collaborate to solve complex problems",
+  "author": "AI Brain <contact@aibrain.dev>",
+  "homepage": "https://aibrain.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aibrain-dev/aibrain-mcp"
+  },
+  "type": "module",
+  "bin": {
+    "aibrain-mcp": "./dist/index.js",
+    "aibrain-setup": "./dist/setup.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["mcp", "ai", "debate", "claude", "gpt", "gemini", "multi-agent", "claude-code", "claude-desktop"],
+  "license": "MIT",
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  }
+}