mcpstore-gateway 1.0.0 → 1.2.0

package/dist/index.d.ts

@@ -1,11 +1,18 @@
 #!/usr/bin/env node
 /**
- * MCP Store Gateway
+ * MCP Store Gateway v1.2.0
  *
  * A single MCP server that gives Claude Code access to ALL your installed MCPs
  * from mcpclaudecode.com. Install MCPs on the website, they appear here instantly.
  *
- * Usage:
+ * Features:
+ *   - Hosted MCPs: tools proxied through our backend (e.g. AI Brain)
+ *   - External MCPs: auto-configured in ~/.mcp.json (e.g. GitHub, Playwright)
+ *
+ * Setup (one command, that's it):
+ *   npx mcpstore-gateway --setup YOUR_API_KEY
+ *
+ * Runtime (called automatically by Claude Code):
  *   npx mcpstore-gateway --api-key YOUR_API_KEY
  */
 export {};

package/dist/index.js

@@ -1,41 +1,150 @@
 #!/usr/bin/env node
 /**
- * MCP Store Gateway
+ * MCP Store Gateway v1.2.0
  *
  * A single MCP server that gives Claude Code access to ALL your installed MCPs
  * from mcpclaudecode.com. Install MCPs on the website, they appear here instantly.
  *
- * Usage:
+ * Features:
+ *   - Hosted MCPs: tools proxied through our backend (e.g. AI Brain)
+ *   - External MCPs: auto-configured in ~/.mcp.json (e.g. GitHub, Playwright)
+ *
+ * Setup (one command, that's it):
+ *   npx mcpstore-gateway --setup YOUR_API_KEY
+ *
+ * Runtime (called automatically by Claude Code):
  *   npx mcpstore-gateway --api-key YOUR_API_KEY
  */
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-// ---------------------------------------------------------------------------
-// Config
-// ---------------------------------------------------------------------------
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
 const GATEWAY_URL = process.env.MCPSTORE_GATEWAY_URL ||
     "https://rshsqjofouqyhzvzezos.supabase.co/functions/v1";
-function getApiKey() {
-    // --api-key flag
-    const flagIdx = process.argv.indexOf("--api-key");
-    if (flagIdx !== -1 && process.argv[flagIdx + 1]) {
-        return process.argv[flagIdx + 1];
+// Prefix for auto-managed MCP entries in .mcp.json
+const MANAGED_PREFIX = "mcpstore-";
+async function syncExternalMcps(apiKey) {
+    try {
+        // 1. Fetch installed external MCPs from the API
+        const res = await fetch(`${GATEWAY_URL}/gateway-sync`, {
+            headers: {
+                Authorization: `Bearer ${apiKey}`,
+                "Content-Type": "application/json",
+            },
+        });
+        if (!res.ok)
+            return; // Silently fail — sync is best-effort
+        const data = (await res.json());
+        const installedSlugs = new Set(data.external_mcps.map((m) => m.slug));
+        // 2. Read current ~/.mcp.json
+        const mcpJsonPath = path.join(os.homedir(), ".mcp.json");
+        let config = {};
+        if (fs.existsSync(mcpJsonPath)) {
+            try {
+                config = JSON.parse(fs.readFileSync(mcpJsonPath, "utf-8"));
+            }
+            catch {
+                return; // Don't mess with a broken config
+            }
+        }
+        if (!config.mcpServers) {
+            config.mcpServers = {};
+        }
+        let changed = false;
+        // 3. Add new external MCPs (prefixed with mcpstore-)
+        for (const mcp of data.external_mcps) {
+            const key = `${MANAGED_PREFIX}${mcp.slug}`;
+            if (!config.mcpServers[key]) {
+                config.mcpServers[key] = mcp.config;
+                changed = true;
+            }
+        }
+        // 4. Remove uninstalled MCPs (only those with our prefix)
+        for (const key of Object.keys(config.mcpServers)) {
+            if (key.startsWith(MANAGED_PREFIX)) {
+                const slug = key.slice(MANAGED_PREFIX.length);
+                if (!installedSlugs.has(slug)) {
+                    delete config.mcpServers[key];
+                    changed = true;
+                }
+            }
+        }
+        // 5. Write back if changed
+        if (changed) {
+            fs.writeFileSync(mcpJsonPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+        }
     }
-    // Environment variable
-    if (process.env.MCPSTORE_API_KEY) {
-        return process.env.MCPSTORE_API_KEY;
+    catch {
+        // Sync is best-effort, never block the server from starting
     }
-    console.error("Error: No API key provided.\n" +
-        "Usage: mcpstore-gateway --api-key YOUR_KEY\n" +
-        "   or: MCPSTORE_API_KEY=YOUR_KEY mcpstore-gateway\n\n" +
-        "Get your API key at https://www.mcpclaudecode.com/dashboard");
-    process.exit(1);
 }
-const API_KEY = getApiKey();
-async function fetchTools() {
+// ---------------------------------------------------------------------------
+// Setup mode: auto-configure .mcp.json
+// ---------------------------------------------------------------------------
+async function runSetup(apiKey) {
+    console.log("");
+    console.log("  MCP Store — Configuration automatique");
+    console.log("  ======================================");
+    console.log("");
+    // 1. Validate the API key
+    console.log("  [1/3] Verification de la cle API...");
+    try {
+        const res = await fetch(`${GATEWAY_URL}/gateway-tools`, {
+            headers: { Authorization: `Bearer ${apiKey}` },
+        });
+        if (!res.ok) {
+            const body = await res.json().catch(() => ({}));
+            console.error(`\n  Erreur: ${body.error || "Cle API invalide"}`);
+            console.error("  Verifiez votre cle sur https://www.mcpclaudecode.com/dashboard\n");
+            process.exit(1);
+        }
+        const data = (await res.json());
+        console.log(`  OK — ${data.count || 0} outil(s) disponible(s)`);
+    }
+    catch {
+        console.error("\n  Erreur: impossible de contacter MCP Store.");
+        console.error("  Verifiez votre connexion internet.\n");
+        process.exit(1);
+    }
+    // 2. Find or create .mcp.json
+    console.log("  [2/3] Configuration de Claude Code...");
+    const mcpJsonPath = path.join(os.homedir(), ".mcp.json");
+    let config = {};
+    if (fs.existsSync(mcpJsonPath)) {
+        try {
+            config = JSON.parse(fs.readFileSync(mcpJsonPath, "utf-8"));
+        }
+        catch {
+            // File exists but isn't valid JSON — we'll create a fresh one
+        }
+    }
+    if (!config.mcpServers) {
+        config.mcpServers = {};
+    }
+    config.mcpServers.mcpstore = {
+        command: "npx",
+        args: ["-y", "mcpstore-gateway", "--api-key", apiKey],
+    };
+    fs.writeFileSync(mcpJsonPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+    console.log(`  OK — ${mcpJsonPath}`);
+    // 3. Done!
+    console.log("  [3/3] Termine !");
+    console.log("");
+    console.log("  +--------------------------------------------------+");
+    console.log("  |  MCP Store est configure !                       |");
+    console.log("  |                                                  |");
+    console.log("  |  Redemarrez Claude Code pour activer vos MCPs.   |");
+    console.log("  |                                                  |");
+    console.log("  |  Installez des MCPs :                            |");
+    console.log("  |  https://www.mcpclaudecode.com/browse            |");
+    console.log("  +--------------------------------------------------+");
+    console.log("");
+}
+async function fetchTools(apiKey) {
     const res = await fetch(`${GATEWAY_URL}/gateway-tools`, {
         headers: {
-            Authorization: `Bearer ${API_KEY}`,
+            Authorization: `Bearer ${apiKey}`,
             "Content-Type": "application/json",
         },
     });
@@ -46,11 +155,11 @@ async function fetchTools() {
     const data = (await res.json());
     return data.tools || [];
 }
-async function callTool(toolName, args) {
+async function callTool(apiKey, toolName, args) {
     const res = await fetch(`${GATEWAY_URL}/gateway-call`, {
         method: "POST",
         headers: {
-            Authorization: `Bearer ${API_KEY}`,
+            Authorization: `Bearer ${apiKey}`,
             "Content-Type": "application/json",
         },
         body: JSON.stringify({ tool: toolName, arguments: args }),
@@ -62,88 +171,60 @@ async function callTool(toolName, args) {
     const data = (await res.json());
     return data.result ?? data;
 }
-// ---------------------------------------------------------------------------
-// MCP Server
-// ---------------------------------------------------------------------------
-const server = new McpServer({
-    name: "MCP Store",
-    version: "1.0.0",
-});
-// Cache tools to avoid re-fetching on every call
-let toolsCache = null;
-let toolsCacheTime = 0;
-const CACHE_TTL_MS = 60_000; // 1 min
-async function getTools() {
-    const now = Date.now();
-    if (toolsCache && now - toolsCacheTime < CACHE_TTL_MS) {
-        return toolsCache;
-    }
-    toolsCache = await fetchTools();
-    toolsCacheTime = now;
-    return toolsCache;
-}
-// Register a dynamic tool handler — we fetch tools from the gateway and
-// register them all. MCP SDK requires registering tools at init time, so we
-// fetch once at startup, then use the call handler to proxy dynamically.
-async function registerTools() {
-    const tools = await getTools();
-    if (tools.length === 0) {
-        // Register a placeholder tool so the server isn't empty
-        server.tool("mcpstore__info", "No MCPs installed yet. Visit https://www.mcpclaudecode.com/browse to install MCPs.", {}, async () => ({
-            content: [
-                {
-                    type: "text",
-                    text: "You have no MCPs installed. Visit https://www.mcpclaudecode.com/browse to browse and install MCPs. They will appear here automatically!",
-                },
-            ],
-        }));
-        return;
-    }
-    for (const tool of tools) {
-        // Build the input schema shape for the MCP SDK
-        const shape = {};
-        const schema = tool.inputSchema;
-        if (schema?.properties) {
-            // We pass through the raw JSON Schema — the SDK accepts it
-            for (const [key, value] of Object.entries(schema.properties)) {
-                shape[key] = value;
-            }
+async function runServer(apiKey) {
+    // Sync external MCPs to ~/.mcp.json before starting
+    await syncExternalMcps(apiKey);
+    const server = new McpServer({
+        name: "MCP Store",
+        version: "1.2.0",
+    });
+    // Register hosted tools (proxied through our backend)
+    try {
+        const tools = await fetchTools(apiKey);
+        if (tools.length === 0) {
+            server.tool("mcpstore__info", "No MCPs installed yet. Visit https://www.mcpclaudecode.com/browse to install MCPs.", {}, async () => ({
+                content: [
+                    {
+                        type: "text",
+                        text: "You have no MCPs installed. Visit https://www.mcpclaudecode.com/browse to browse and install MCPs. They will appear here automatically!",
+                    },
+                ],
+            }));
         }
-        server.tool(tool.name, tool.description, 
-        // Pass the raw JSON Schema as-is; the SDK will use it for validation
-        shape, async (args) => {
-            try {
-                const result = await callTool(tool.name, args);
-                const text = typeof result === "string" ? result : JSON.stringify(result, null, 2);
-                return {
-                    content: [{ type: "text", text }],
-                };
-            }
-            catch (err) {
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: `Error: ${err.message}`,
-                        },
-                    ],
-                    isError: true,
-                };
+        else {
+            for (const tool of tools) {
+                const shape = {};
+                const schema = tool.inputSchema;
+                if (schema?.properties) {
+                    for (const [key, value] of Object.entries(schema.properties)) {
+                        shape[key] = value;
+                    }
+                }
+                server.tool(tool.name, tool.description, shape, async (args) => {
+                    try {
+                        const result = await callTool(apiKey, tool.name, args);
+                        const text = typeof result === "string"
+                            ? result
+                            : JSON.stringify(result, null, 2);
+                        return { content: [{ type: "text", text }] };
+                    }
+                    catch (err) {
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: `Error: ${err.message}`,
+                                },
+                            ],
+                            isError: true,
+                        };
+                    }
+                });
             }
-        });
-    }
-}
-// ---------------------------------------------------------------------------
-// Main
-// ---------------------------------------------------------------------------
-async function main() {
-    try {
-        await registerTools();
+        }
     }
     catch (err) {
         console.error("Failed to fetch tools from MCP Store:", err.message);
-        console.error("Make sure your API key is valid and you have MCPs installed at https://www.mcpclaudecode.com/browse");
-        // Still start the server with an error tool
         server.tool("mcpstore__error", "MCP Store connection error", {}, async () => ({
             content: [
                 {
@@ -157,4 +238,34 @@ async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
 }
+// ---------------------------------------------------------------------------
+// Entry point
+// ---------------------------------------------------------------------------
+async function main() {
+    // --setup mode
+    const setupIdx = process.argv.indexOf("--setup");
+    if (setupIdx !== -1) {
+        const key = process.argv[setupIdx + 1];
+        if (!key) {
+            console.error("Usage: npx mcpstore-gateway --setup YOUR_API_KEY");
+            console.error("\nGet your API key at https://www.mcpclaudecode.com/dashboard");
+            process.exit(1);
+        }
+        await runSetup(key);
+        process.exit(0);
+    }
+    // --api-key runtime mode
+    const flagIdx = process.argv.indexOf("--api-key");
+    const apiKey = (flagIdx !== -1 && process.argv[flagIdx + 1]) ||
+        process.env.MCPSTORE_API_KEY ||
+        "";
+    if (!apiKey) {
+        console.error("Error: No API key provided.\n" +
+            "Setup:   npx mcpstore-gateway --setup YOUR_KEY\n" +
+            "Runtime: npx mcpstore-gateway --api-key YOUR_KEY\n\n" +
+            "Get your API key at https://www.mcpclaudecode.com/dashboard");
+        process.exit(1);
+    }
+    await runServer(apiKey);
+}
 main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcpstore-gateway",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "MCP Store Gateway — One MCP server for all your installed MCPs from mcpclaudecode.com",
   "keywords": ["mcp", "claude", "claude-code", "ai", "gateway", "marketplace"],
   "license": "MIT",