tg2ai-mcp 0.1.0

package/README.md

@@ -0,0 +1,56 @@
+# tg2ai-mcp
+
+> **TG2AI Remote SSE Bridge Client** — Ultra-lightweight, zero-dependency proxy bridge connecting your local AI development environment (Claude Desktop, Cursor IDE, Windsurf) to your remote secure TG2AI API Gateway over Server-Sent Events (SSE).
+
+---
+
+## ⚡ Features
+
+* **Zero-Dependencies:** Runs natively on standard Node.js without heavy compiler chains.
+* **Instant Start:** Zero build time, starts in `< 5ms`.
+* **Resource Efficient:** Consumes `< 15MB` of RAM.
+* **Bi-directional Stream Pipe:** Translates local Standard I/O (stdio) streams of Claude Desktop / Cursor IDE into cloud-based SSE connection seamlessly.
+
+---
+
+## 🚀 Installation & Configuration
+
+You do not need to install this package manually. You can execute it directly on the fly using `npx`.
+
+### 1. Claude Desktop Configuration
+
+Add the following block to your `claude_desktop_config.json` (typically located in `%APPDATA%\Claude\claude_desktop_config.json` on Windows or `~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+
+```json
+{
+  "mcpServers": {
+    "tg2ai": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "tg2ai-mcp@latest",
+        "--url=https://your-api-gateway.com/api/mcp",
+        "--token=YOUR_SECURE_HMAC_TOKEN"
+      ]
+    }
+  }
+}
+```
+
+### 2. Cursor IDE / Windsurf Configuration
+
+Add a new MCP server in your IDE settings:
+* **Name:** `tg2ai`
+* **Type:** `command`
+* **Command:**
+  ```bash
+  npx -y tg2ai-mcp@latest --url=https://your-api-gateway.com/api/mcp --token=YOUR_SECURE_HMAC_TOKEN
+  ```
+
+---
+
+## 🔒 Security & Privacy
+
+This client is a simple transparent proxy bridge. It does not contain any business logic, scraping algorithms, database connections, or secret keys. It simply pipes JSON-RPC messages between your local IDE and your private TG2AI API server securely over HTTPS.
+
+`Find the Delta. Close the Gap. ./GΔP 2026`

package/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "tg2ai-mcp",
+  "version": "0.1.0",
+  "description": "TG2AI Commercial Remote MCP Bridge Client",
+  "private": false,
+  "main": "src/index.js",
+  "type": "module",
+  "bin": "./src/index.js",
+  "scripts": {
+    "start": "node src/index.js",
+    "dev": "node src/index.js"
+  },
+  "dependencies": {}
+}

package/src/index.js

@@ -0,0 +1,130 @@
+#!/usr/bin/env node
+import http from "http";
+import https from "https";
+import readline from "readline";
+import { URL } from "url";
+
+// ---------------------------------------------------------------------------
+// Parse arguments
+// ---------------------------------------------------------------------------
+const args = process.argv.slice(2);
+const urlArg = args.find(arg => arg.startsWith("--url="))?.split("=")[1];
+const tokenArg = args.find(arg => arg.startsWith("--token="))?.split("=")[1];
+
+if (!urlArg || !tokenArg) {
+  console.error("\n========================================================");
+  console.error("❌ TG2AI Commercial Remote MCP Bridge Client Error");
+  console.error("========================================================");
+  console.error("This package requires '--url' and '--token' parameters to function.");
+  console.error("\n👉 How to configure in Claude Desktop (claude_desktop_config.json):");
+  console.error(JSON.stringify({
+    mcpServers: {
+      tg2ai: {
+        command: "npx",
+        args: [
+          "-y",
+          "tg2ai-mcp@latest",
+          "--url=https://your-render-app.onrender.com/api/mcp",
+          "--token=YOUR_GENERATED_TOKEN"
+        ]
+      }
+    }
+  }, null, 2));
+  console.error("\n👉 How to configure in Cursor IDE (stdio mode command):");
+  console.error("npx -y tg2ai-mcp@latest --url=https://your-render-app.onrender.com/api/mcp --token=YOUR_GENERATED_TOKEN");
+  console.error("========================================================\n");
+  process.exit(1);
+}
+
+// =========================================================================
+// Pure high-performance Stdio-to-SSE HTTP Proxy Bridge (Zero-Dependencies)
+// =========================================================================
+console.error(`[Bridge] Connecting to remote TG2AI API Gateway at ${urlArg}...`);
+
+const urlObj = new URL(urlArg);
+urlObj.searchParams.set("token", tokenArg);
+
+const clientModule = urlObj.protocol === "https:" ? https : http;
+let postUrlPath = "";
+
+// 1. Establish long-lived Server-Sent Events stream connection
+const sseReq = clientModule.get(urlObj.toString(), {
+  headers: {
+    "Accept": "text/event-stream",
+    "Cache-Control": "no-cache",
+    "Connection": "keep-alive"
+  }
+}, (res) => {
+  let buffer = "";
+  res.setEncoding("utf-8");
+  res.on("data", (chunk) => {
+    buffer += chunk;
+    const lines = buffer.split("\n");
+    buffer = lines.pop() || "";
+    
+    let currentEvent = "";
+    for (const line of lines) {
+      if (line.startsWith("event: ")) {
+        currentEvent = line.slice(7).trim();
+      } else if (line.startsWith("data: ")) {
+        const dataStr = line.slice(6).trim();
+        if (currentEvent === "endpoint") {
+          // Extracted POST destination endpoint
+          postUrlPath = dataStr;
+          console.error(`[Bridge] Connected successfully! Remote session established.`);
+        } else if (currentEvent === "message") {
+          // Forward remote JSON-RPC responses directly to Claude Desktop stdout
+          process.stdout.write(dataStr + "\n");
+        }
+      } else if (line.trim() === "") {
+        currentEvent = "";
+      }
+    }
+  });
+  
+  res.on("end", () => {
+    console.error("[Bridge] Remote SSE connection closed.");
+    process.exit(0);
+  });
+});
+
+sseReq.on("error", (err) => {
+  console.error(`[Bridge] Remote SSE Connection Error: ${err.message}`);
+  process.exit(1);
+});
+
+// 2. Read JSON-RPC requests from Claude Desktop stdin and POST them to Render
+const rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout,
+  terminal: false
+});
+
+rl.on("line", (line) => {
+  if (!line.trim()) return;
+  
+  // Pause processing stdin line until SSE handshake establishes postUrlPath
+  if (!postUrlPath) {
+    setTimeout(() => rl.emit("line", line), 100);
+    return;
+  }
+
+  const postUrl = new URL(postUrlPath, urlArg);
+  const postReq = clientModule.request(postUrl.toString(), {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "Content-Length": Buffer.byteLength(line)
+    }
+  }, (res) => {
+    // Consume response stream
+    res.on("data", () => {});
+  });
+
+  postReq.on("error", (err) => {
+    console.error(`[Bridge] POST request failed: ${err.message}`);
+  });
+
+  postReq.write(line);
+  postReq.end();
+});