toolbox-co-mcp-bridge 1.0.0

package/README.md

@@ -0,0 +1,32 @@
+# @toolbox-co/mcp
+
+This is a lightweight executable bridge proxy designed to connect local AI Agents (like **Claude Desktop**) to the remote **ToolBox Co.** micro-services seamlessly using the Model Context Protocol (MCP).
+
+## Why does this exist?
+Claude Desktop and other standardized MCP clients communicate strictly over local standard I/O streams (`stdio`) for maximum security and local isolation. They do not natively support speaking to remote `SSE` (Server-Sent Events) HTTP endpoints.
+
+This package bridges that gap by running locally on the user's machine, listening to Claude's `stdio`, and forwarding requests back and forth over HTTP to the hosted ToolBox Co. SaaS.
+
+## How to execute
+
+Paste the following into your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "toolbox-co": {
+      "command": "npx",
+      "args": ["-y", "@toolbox-co/mcp"]
+    }
+  }
+}
+```
+
+## How to publish
+
+1. Run `npm install` inside this directory to ensure `package-lock.json` is generated.
+2. Ensure you are logged into NPM (`npm login`).
+3. Publish to the public registry constraint free:
+   \`\`\`bash
+   npm publish --access public
+   \`\`\`

package/index.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+import EventSource from "eventsource";
+import fetch from "node-fetch";
+
+// The hardcoded remote SSE endpoint for ToolBox Co. SaaS tools
+const sseUrl = "https://toolbox-mcp-1058072229791.us-central1.run.app/sse";
+
+const es = new EventSource(sseUrl);
+let postEndpoint = '';
+
+// When the MCP server initializes the connection, it emits an 'endpoint' event
+// containing the specific URI we must POST messages to.
+es.addEventListener("endpoint", (e) => {
+    try {
+        postEndpoint = new URL(e.data, sseUrl).toString();
+    } catch (err) {
+        console.error("Failed to parse POST endpoint:", err);
+    }
+});
+
+// Any messages received from the remote MCP server must be forwarded 
+// locally to Claude Desktop via standard output (stdout).
+es.onmessage = (e) => {
+    console.log(e.data);
+};
+
+es.onerror = (e) => {
+    console.error("SSE connection error:", e);
+};
+
+// Listen directly on standard input (stdin) for JSON-RPC messages 
+// coming from the local MCP Client (Claude Desktop).
+process.stdin.on('data', async (data) => {
+    if (!postEndpoint) {
+        // Can optionally log a warning but the protocol expects JSON-RPC responses only in stdout.
+        return; 
+    }
+    
+    // Tools or clients might batch messages separated by newlines
+    const messages = data.toString().trim().split('\n');
+    
+    for (const msg of messages) {
+        if (!msg.trim()) continue;
+        
+        try {
+            await fetch(postEndpoint, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: msg
+            });
+        } catch (e) {
+            console.error("Failed to forward message from Claude to ToolBox:", e);
+        }
+    }
+});
+
+// Keep process alive indefinitely
+setInterval(() => {}, 1000 * 60 * 60);

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "toolbox-co-mcp-bridge",
+  "version": "1.0.0",
+  "description": "A bridge proxy to connect local STDIO-based MCP clients (like Claude Desktop) to the remote ToolBox Co. SSE endpoint.",
+  "type": "module",
+  "bin": {
+    "toolbox-mcp": "./index.js"
+  },
+  "scripts": {
+    "start": "node index.js"
+  },
+  "keywords": [
+    "mcp",
+    "model context protocol",
+    "toolbox-co",
+    "sse",
+    "proxy"
+  ],
+  "author": "ToolBox Co.",
+  "license": "MIT",
+  "dependencies": {
+    "eventsource": "^2.0.2",
+    "node-fetch": "^3.3.2"
+  }
+}