create-multicast 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,118 @@
+# create-multicast
+
+One command to set up [Multicast](https://github.com/mayankbohra/multicast) — an MCP gateway that gives Claude.ai access to all your MCP servers through a single integration, with parallel execution.
+
+## Usage
+
+```bash
+npx create-multicast
+```
+
+## What It Does
+
+1. **Scans your machine** for existing MCP configurations
+   - Claude Code (`~/.claude.json`)
+   - Claude Desktop (`~/Library/Application Support/Claude/claude_desktop_config.json`)
+   - Cursor (`~/.cursor/mcp.json`)
+   - VS Code (`.vscode/mcp.json`)
+
+2. **Classifies your servers**
+   - HTTP servers (compatible with Multicast)
+   - stdio servers (local only, not compatible)
+
+3. **Lets you select** which servers to register
+
+4. **Auto-detects credentials** from existing configs
+   - Authorization headers
+   - API keys, tokens, secrets from env vars
+
+5. **Deploys to Cloudflare Workers**
+   - Creates D1 database for tool discovery cache
+   - Sets encrypted env vars for server credentials
+   - Deploys the Worker
+
+6. **Outputs the URL** to add to Claude.ai
+
+## Example
+
+```
+$ npx create-multicast
+
+  create-multicast
+
+  MCP gateway for Claude.ai — one integration, all your servers, parallel execution.
+  Runs on Cloudflare Workers (free tier). Costs $0/month.
+
+  Scanning for existing MCP configurations...
+
+  Found 5 MCP servers:
+
+  ✓ context-hub     https://context-hub.user.workers.dev    [HTTP]
+  ✓ supabase-mcp    https://supabase-mcp.example.com        [HTTP]
+  ✗ filesystem      command: npx @mcp/filesystem             [stdio — skipped]
+  ✗ git             command: npx @mcp/git                    [stdio — skipped]
+  ✓ github-mcp      https://github-mcp.example.com           [HTTP]
+
+  2 stdio servers skipped — they run locally and can't be called from a cloud worker.
+
+  Select servers to register with Multicast:
+  ◼ context-hub
+  ◼ supabase-mcp
+  ◼ github-mcp
+
+  ...deploying...
+
+  Deployed! https://multicast.user.workers.dev/mcp
+
+  Add to Claude.ai:
+  → Settings → Integrations → Add MCP Server
+  → Paste the URL above
+```
+
+## What is Multicast?
+
+Multicast is a free, open-source MCP gateway on Cloudflare Workers.
+
+**The problem:** Claude.ai requires a separate integration for each MCP server. 5 servers = 5 integrations, 5 OAuth setups, and sequential tool execution.
+
+**The solution:** Add Multicast once. It connects to all your MCP servers and calls them in parallel.
+
+- One integration instead of many
+- Parallel execution instead of sequential
+- Unified tool discovery
+- $0/month on Cloudflare Workers free tier
+
+## How Credentials Work
+
+- You deploy your **own** Multicast instance on your Cloudflare account
+- Server URLs and auth tokens are stored as **encrypted environment variables**
+- Credentials never leave your infrastructure
+- No shared servers, no central authority
+
+## Adding Servers After Setup
+
+```bash
+# Add a new server
+npx wrangler secret put MCP_SERVER_NEWSERVICE
+npx wrangler secret put MCP_AUTH_NEWSERVICE   # if auth needed
+npx wrangler deploy
+```
+
+## Requirements
+
+- Node.js 18+
+- Free Cloudflare account
+- At least one HTTP-accessible MCP server
+
+## stdio vs HTTP
+
+Multicast runs in the cloud. It can only call MCP servers with HTTP endpoints. Local stdio servers (filesystem, git, sqlite) are detected but skipped with an explanation.
+
+## Links
+
+- [GitHub](https://github.com/mayankbohra/multicast)
+- [Cloudflare Workers](https://workers.cloudflare.com/)
+
+## License
+
+MIT

package/dist/cli.js

@@ -256,45 +256,88 @@ async function main() {
             process.exit(0);
         }
         const selectedNames = selections;
-        // Confirm/collect auth for each selected server
+        // Auto-detect auth for each selected server
+        // Strategy:
+        //   1. If auth found in config → use it silently
+        //   2. If no auth → probe the server to check if it needs auth
+        //   3. Only ask the user if we can't determine automatically
+        const authSpinner = p.spinner();
+        authSpinner.start("Detecting authentication requirements...");
         for (const name of selectedNames) {
             const server = httpServers.find((s) => s.name === name);
             let auth = server.auth;
+            let authStatus;
             if (auth) {
-                const useExisting = await p.confirm({
-                    message: `${name} — found auth credentials. Use them?`,
-                    initialValue: true,
-                });
-                if (p.isCancel(useExisting)) {
-                    p.cancel("Setup cancelled.");
-                    process.exit(0);
-                }
-                if (!useExisting)
-                    auth = undefined;
+                // Auth found in existing config — use it
+                authStatus = "credentials found in config";
             }
-            if (!auth) {
-                const needsAuth = await p.confirm({
-                    message: `${name} — does this server require authentication?`,
-                    initialValue: false,
-                });
-                if (!p.isCancel(needsAuth) && needsAuth) {
-                    const authResult = await p.text({
-                        message: `Enter auth header for ${name}:`,
-                        placeholder: "Bearer your-token-here",
+            else {
+                // No auth in config — probe the server
+                try {
+                    const probe = await fetch(server.url, {
+                        method: "POST",
+                        headers: { "Content-Type": "application/json" },
+                        body: JSON.stringify({
+                            jsonrpc: "2.0",
+                            method: "initialize",
+                            params: {
+                                protocolVersion: "2024-11-05",
+                                capabilities: {},
+                                clientInfo: { name: "multicast-probe", version: "0.1.0" },
+                            },
+                            id: "probe",
+                        }),
+                        signal: AbortSignal.timeout(5000),
                     });
-                    if (p.isCancel(authResult)) {
-                        p.cancel("Setup cancelled.");
-                        process.exit(0);
+                    if (probe.status === 401 || probe.status === 403) {
+                        // Server requires auth but we don't have it — need to ask
+                        authStatus = "needs-auth";
+                    }
+                    else {
+                        // Server responded without auth — no auth needed
+                        authStatus = "no auth required";
                     }
-                    auth = authResult;
+                }
+                catch {
+                    // Can't reach server — assume no auth (will fail later with clear error)
+                    authStatus = "unreachable (skipping auth)";
                 }
             }
+            if (authStatus === "needs-auth") {
+                // Only ask when we KNOW the server needs auth but we don't have it
+                authSpinner.stop(`${pc.yellow("!")} ${name} requires authentication.`);
+                const authResult = await p.text({
+                    message: `Enter auth header for ${pc.bold(name)}:`,
+                    placeholder: "Bearer your-token-here",
+                    validate: (v) => {
+                        if (!v.trim())
+                            return "Auth header is required — server returned 401";
+                        return undefined;
+                    },
+                });
+                if (p.isCancel(authResult)) {
+                    p.cancel("Setup cancelled.");
+                    process.exit(0);
+                }
+                auth = authResult;
+                authSpinner.start("Detecting authentication requirements...");
+            }
             selectedServers.push({
                 name,
                 url: server.url,
                 auth: auth || undefined,
             });
         }
+        authSpinner.stop("Authentication configured.");
+        // Show auth summary
+        for (const s of selectedServers) {
+            if (s.auth) {
+                p.log.message(`  ${pc.green("✓")} ${pc.bold(s.name)} — auth configured`);
+            }
+            else {
+                p.log.message(`  ${pc.green("✓")} ${pc.bold(s.name)} — no auth needed`);
+            }
+        }
     }
     // Option to add servers manually
     let addMore = true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-multicast",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Create a Multicast MCP gateway — one command to scaffold, configure, and deploy your parallel MCP server.",
   "type": "module",
   "bin": "./dist/cli.js",