@tesselunits/mcp-connector 1.0.2

package/README.dev.md

@@ -0,0 +1,54 @@
+# Tessel MCP Connector
+
+see [README.md](README.md) for usage instructions.
+
+## Features
+
+- **HTTP Stream Bridge**: Bridges remote Server-Sent Events (SSE) or Fetch-based streams to Stdio.
+- **Auto Session ID**: Manages session continuity automatically.
+- **Authentication**: Supports Bearer token authentication.
+
+## Development
+
+```bash
+npm install
+npm run build
+```
+
+## Deployment
+
+This package is automatically published to npm via GitHub Actions.
+
+### Manual Release
+
+To trigger a new version and publish to npm:
+
+1. Go to **GitHub Actions** tab.
+2. Select **Publish MCP Connector**.
+3. Click **Run workflow**.
+4. Choose the `Version type` (patch, minor, or major).
+
+The workflow will:
+
+- Update the version in `package.json`.
+- Inject the `NEXT_PUBLIC_APP_URL` from GitHub Secrets into the build.
+- Publish the package to npmjs.com.
+
+### Local Publication (Alternative)
+
+If you need to publish manually from your local machine:
+
+```bash
+# 1. Ensure you are logged in to npm
+npm login
+
+# 2. Build with the target app URL
+NEXT_PUBLIC_APP_URL=https://your-app.com npm run build
+
+# 3. Publish
+npm publish --access public
+```
+
+## License
+
+MIT

package/README.md

@@ -0,0 +1,26 @@
+# Tessel Units MCP Connector
+
+A bridge to connect to the Tessel Units MCP server at https://tesselunits.art.
+
+## Usage
+
+Go to your profile page at https://tesselunits.art/en/profile and create/copy your API token.
+
+```bash
+npx @tesselunits/mcp-connector <YOUR_API_TOKEN>
+```
+
+### Example for Claude Desktop
+
+Add the following to your `claude_desktop_config.json`:
+
+```json
+{
+    "mcpServers": {
+        "tessel": {
+            "command": "npx",
+            "args": ["@tesselunits/mcp-connector", "<YOUR_API_TOKEN>"]
+        }
+    }
+}
+```

package/dist/index.d.mts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,113 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/index.ts
+var import_streamableHttp = require("@modelcontextprotocol/sdk/client/streamableHttp.js");
+var import_stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
+var import_crypto = __toESM(require("crypto"));
+async function main() {
+  let url;
+  let token;
+  const bakedUrl = true ? "https://tesselunits.art" : void 0;
+  if (bakedUrl) {
+    url = bakedUrl;
+    token = process.argv[2];
+  } else {
+    url = process.argv[2];
+    token = process.argv[3];
+  }
+  if (!url || !token) {
+    if (bakedUrl) {
+      console.error("Usage: npx tessel-mcp-connector <TOKEN>");
+    } else {
+      console.error("Usage: npx tessel-mcp-connector <URL> <TOKEN>");
+    }
+    console.error("");
+    console.error("Arguments:");
+    if (!bakedUrl) {
+      console.error("  URL    The base URL of the remote MCP server");
+    }
+    console.error("  TOKEN  Your authentication token");
+    process.exit(1);
+  }
+  if (!url.endsWith("/api/mcp") && !url.includes("/api/mcp?")) {
+    const urlObj = new URL(url);
+    urlObj.pathname = "/api/mcp";
+    url = urlObj.toString();
+  }
+  const sessionId = import_crypto.default.randomUUID();
+  let connectionUrl;
+  try {
+    connectionUrl = new URL(url);
+  } catch {
+    console.error(`Invalid URL: ${url}`);
+    process.exit(1);
+  }
+  connectionUrl.searchParams.set("sessionId", sessionId);
+  connectionUrl.searchParams.set("token", token);
+  console.error(`[Bridge] Connecting to ${connectionUrl.origin}${connectionUrl.pathname}...`);
+  const transport = new import_streamableHttp.StreamableHTTPClientTransport(connectionUrl, {
+    sessionId,
+    requestInit: {
+      headers: { "Authorization": `Bearer ${token}` }
+    }
+  });
+  try {
+    await transport.start();
+    console.error("[Bridge] HTTP Transport connected");
+    const stdioTransport = new import_stdio.StdioServerTransport();
+    stdioTransport.onmessage = async (message) => {
+      await transport.send(message);
+    };
+    transport.onmessage = async (message) => {
+      await stdioTransport.send(message);
+    };
+    await stdioTransport.start();
+    console.error("[Bridge] Stdio Transport started. Bridge is active.");
+    transport.onclose = () => {
+      console.error("[Bridge] Closed by server.");
+      process.exit(0);
+    };
+    stdioTransport.onclose = () => {
+      console.error("[Bridge] Closed by stdio.");
+      process.exit(0);
+    };
+    process.on("SIGINT", () => {
+      console.error("[Bridge] Caught interrupt signal");
+      process.exit(0);
+    });
+    process.on("SIGTERM", () => {
+      console.error("[Bridge] Caught terminate signal");
+      process.exit(0);
+    });
+  } catch (error) {
+    console.error("[Bridge] Failed to connect:", error);
+    process.exit(1);
+  }
+}
+main().catch((err) => {
+  console.error("Unexpected error:", err);
+  process.exit(1);
+});

package/dist/index.mjs

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import crypto from "crypto";
+async function main() {
+  let url;
+  let token;
+  const bakedUrl = true ? "https://tesselunits.art" : void 0;
+  if (bakedUrl) {
+    url = bakedUrl;
+    token = process.argv[2];
+  } else {
+    url = process.argv[2];
+    token = process.argv[3];
+  }
+  if (!url || !token) {
+    if (bakedUrl) {
+      console.error("Usage: npx tessel-mcp-connector <TOKEN>");
+    } else {
+      console.error("Usage: npx tessel-mcp-connector <URL> <TOKEN>");
+    }
+    console.error("");
+    console.error("Arguments:");
+    if (!bakedUrl) {
+      console.error("  URL    The base URL of the remote MCP server");
+    }
+    console.error("  TOKEN  Your authentication token");
+    process.exit(1);
+  }
+  if (!url.endsWith("/api/mcp") && !url.includes("/api/mcp?")) {
+    const urlObj = new URL(url);
+    urlObj.pathname = "/api/mcp";
+    url = urlObj.toString();
+  }
+  const sessionId = crypto.randomUUID();
+  let connectionUrl;
+  try {
+    connectionUrl = new URL(url);
+  } catch {
+    console.error(`Invalid URL: ${url}`);
+    process.exit(1);
+  }
+  connectionUrl.searchParams.set("sessionId", sessionId);
+  connectionUrl.searchParams.set("token", token);
+  console.error(`[Bridge] Connecting to ${connectionUrl.origin}${connectionUrl.pathname}...`);
+  const transport = new StreamableHTTPClientTransport(connectionUrl, {
+    sessionId,
+    requestInit: {
+      headers: { "Authorization": `Bearer ${token}` }
+    }
+  });
+  try {
+    await transport.start();
+    console.error("[Bridge] HTTP Transport connected");
+    const stdioTransport = new StdioServerTransport();
+    stdioTransport.onmessage = async (message) => {
+      await transport.send(message);
+    };
+    transport.onmessage = async (message) => {
+      await stdioTransport.send(message);
+    };
+    await stdioTransport.start();
+    console.error("[Bridge] Stdio Transport started. Bridge is active.");
+    transport.onclose = () => {
+      console.error("[Bridge] Closed by server.");
+      process.exit(0);
+    };
+    stdioTransport.onclose = () => {
+      console.error("[Bridge] Closed by stdio.");
+      process.exit(0);
+    };
+    process.on("SIGINT", () => {
+      console.error("[Bridge] Caught interrupt signal");
+      process.exit(0);
+    });
+    process.on("SIGTERM", () => {
+      console.error("[Bridge] Caught terminate signal");
+      process.exit(0);
+    });
+  } catch (error) {
+    console.error("[Bridge] Failed to connect:", error);
+    process.exit(1);
+  }
+}
+main().catch((err) => {
+  console.error("Unexpected error:", err);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,37 @@
+{
+    "name": "@tesselunits/mcp-connector",
+    "version": "1.0.2",
+    "description": "A bridge to connect Model Context Protocol (MCP) servers over HTTP streams to local Stdio",
+    "main": "./dist/index.js",
+    "module": "./dist/index.mjs",
+    "types": "./dist/index.d.ts",
+    "bin": {
+        "tessel-mcp-connector": "./dist/index.js"
+    },
+    "files": [
+        "dist",
+        "README.md"
+    ],
+    "scripts": {
+        "build": "tsup src/index.ts --clean --format cjs,esm --dts --define.MCP_URL=\"\\\"$NEXT_PUBLIC_APP_URL\\\"\"",
+        "build:local": "NEXT_PUBLIC_APP_URL=$(grep NEXT_PUBLIC_APP_URL ../../.env.local | cut -d '=' -f2) npm run build",
+        "dev": "tsup src/index.ts --format cjs,esm --watch --dts",
+        "start": "node dist/index.js",
+        "lint": "tsc --noEmit"
+    },
+    "keywords": [
+        "mcp",
+        "model-context-protocol",
+        "bridge",
+        "tessel-units"
+    ],
+    "author": "TesselUnits",
+    "license": "MIT",
+    "dependencies": {
+        "@modelcontextprotocol/sdk": "^1.1.0"
+    },
+    "devDependencies": {
+        "typescript": "^5.0.0",
+        "tsup": "^8.0.0"
+    }
+}