@rsv_ink/ink-hub-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 João Alves
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,54 @@
+# @rsv_ink/ink-hub-mcp
+
+Cliente local que conecta Claude Desktop, Cursor e Zed ao servidor MCP do **Ink Hub**.
+
+Clientes como o Claude Desktop só falam MCP via `stdio` — eles não conseguem se conectar diretamente a um servidor MCP remoto. Este pacote roda na sua máquina, recebe os comandos via `stdio` e repassa tudo para o servidor do Ink Hub de forma transparente.
+
+## Uso
+
+Não precisa instalar nada. Adicione esse bloco no `claude_desktop_config.json` (ou config equivalente do Cursor / Zed):
+
+```json
+{
+  "mcpServers": {
+    "ink-hub": {
+      "command": "npx",
+      "args": ["-y", "@rsv_ink/ink-hub-mcp"],
+      "env": {
+        "INK_HUB_URL": "https://seu-ink-hub.exemplo.com",
+        "MCP_AUTH_TOKEN": "seu-token"
+      }
+    }
+  }
+}
+```
+
+Reinicie o cliente MCP — pronto.
+
+## Variáveis de ambiente
+
+| Variável         | Obrigatória | Descrição                                                |
+| ---------------- | ----------- | -------------------------------------------------------- |
+| `INK_HUB_URL`    | sim         | URL base do servidor Ink Hub (sem barra final).          |
+| `MCP_AUTH_TOKEN` | sim         | Token enviado em `Authorization: Bearer <token>`.        |
+| `DEBUG`          | não         | `true` para logar todas as mensagens MCP em `stderr`.    |
+
+## Desenvolvimento
+
+```bash
+git clone https://github.com/rsv-ink/ink-hub-mcp.git
+cd ink-hub-mcp
+npm install
+npm test
+npm run build
+```
+
+Para subir o proxy localmente:
+
+```bash
+INK_HUB_URL=https://... MCP_AUTH_TOKEN=... npm run dev
+```
+
+## Licença
+
+MIT — veja [LICENSE](./LICENSE).

package/dist/index.js

@@ -0,0 +1,143 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { JSONRPCRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+
+// src/transport.ts
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+var isDebug = process.env.DEBUG === "true";
+var InkHubTransport = class {
+  constructor(baseUrl, authToken) {
+    this.baseUrl = baseUrl;
+    this.authToken = authToken;
+    const authHeaders = {
+      Authorization: `Bearer ${this.authToken}`
+    };
+    this.client = new StreamableHTTPClientTransport(this.baseUrl, {
+      requestInit: {
+        headers: authHeaders
+      }
+    });
+    this.client.onmessage = (message) => {
+      if (isDebug) console.error(`[DEBUG-MCP-RECV] <- ${JSON.stringify(message)}`);
+      this.onmessage?.(message);
+    };
+    this.client.onerror = (error) => {
+      console.error("[TRANSPORT-ERROR] HTTP Transport error:", error);
+      this.onerror?.(error);
+    };
+    this.client.onclose = () => {
+      if (isDebug) console.error("[DEBUG-MCP-CLOSE] Remote SSE connection closed");
+      this.onclose?.();
+    };
+  }
+  baseUrl;
+  authToken;
+  client;
+  onclose;
+  onerror;
+  onmessage;
+  async start() {
+    if (isDebug) console.error(`[DEBUG-MCP-START] Connecting to ${this.baseUrl.toString()}`);
+    await this.client.start();
+  }
+  async close() {
+    if (isDebug) console.error("[DEBUG-MCP-CLOSE] Closing remote connection");
+    await this.client.close();
+  }
+  async send(message) {
+    if (isDebug) console.error(`[DEBUG-MCP-SEND] -> ${JSON.stringify(message)}`);
+    await this.client.send(message);
+  }
+};
+
+// src/index.ts
+import process2 from "process";
+async function run() {
+  const serverUrlStr = process2.env.INK_HUB_URL;
+  const authToken = process2.env.MCP_AUTH_TOKEN;
+  if (!serverUrlStr) {
+    console.error("Error: INK_HUB_URL environment variable is not set.");
+    console.error("Set INK_HUB_URL in the MCP client config to point to your Ink Hub server.");
+    process2.exit(1);
+  }
+  if (!authToken) {
+    console.error("Error: MCP_AUTH_TOKEN environment variable is not set.");
+    process2.exit(1);
+  }
+  let serverUrl;
+  try {
+    serverUrl = new URL(`${serverUrlStr.replace(/\/$/, "")}/api/mcp`);
+  } catch (error) {
+    console.error(
+      `Error: Invalid INK_HUB_URL ("${serverUrlStr}"). Must be a valid URL.`
+    );
+    process2.exit(1);
+  }
+  const remoteTransport = new InkHubTransport(serverUrl, authToken);
+  remoteTransport.onerror = (error) => {
+    console.error(
+      "Warning: connection issue with the Ink Hub server:",
+      error.message
+    );
+  };
+  remoteTransport.onclose = () => {
+    console.error(
+      "Connection to the Ink Hub server was closed. The server may have timed out or restarted."
+    );
+    stdioTransport.onclose?.();
+    process2.exit(1);
+  };
+  const stdioTransport = new StdioServerTransport();
+  stdioTransport.onerror = (error) => {
+    console.error("stdio connection error:", error.message);
+  };
+  stdioTransport.onclose = () => {
+    console.error("stdio connection closed. Shutting down proxy.");
+    remoteTransport.close().catch(() => {
+    });
+    process2.exit(0);
+  };
+  remoteTransport.onmessage = async (message) => {
+    try {
+      await stdioTransport.send(message);
+    } catch (err) {
+      console.error("Error routing message from server to stdio:", err);
+      process2.exit(1);
+    }
+  };
+  stdioTransport.onmessage = async (message) => {
+    try {
+      await remoteTransport.send(message);
+    } catch (err) {
+      console.error("Error routing message from stdio to server:", err);
+      const parsedRequest = JSONRPCRequestSchema.safeParse(message);
+      if (parsedRequest.success) {
+        await stdioTransport.send({
+          jsonrpc: "2.0",
+          id: parsedRequest.data.id,
+          error: {
+            code: -32603,
+            message: `Proxy failed to route message: ${err instanceof Error ? err.message : String(err)}`
+          }
+        }).catch(() => {
+        });
+      }
+    }
+  };
+  try {
+    console.error("Connecting to Ink Hub MCP server...");
+    await remoteTransport.start();
+    console.error("Connected. Starting stdio transport...");
+    await stdioTransport.start();
+  } catch (error) {
+    const msg = error instanceof Error ? error.message : String(error);
+    console.error("Fatal error initializing transports:", msg);
+    process2.exit(1);
+  }
+}
+run().catch((err) => {
+  console.error("Unhandled error in proxy:", err);
+  process2.exit(1);
+});

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@rsv_ink/ink-hub-mcp",
+  "version": "0.1.0",
+  "description": "Local MCP client that bridges stdio-based MCP clients (Claude Desktop, Cursor, Zed) to the remote Ink Hub MCP server.",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "anthropic",
+    "ink-hub",
+    "stdio",
+    "proxy"
+  ],
+  "license": "MIT",
+  "author": "João Alves <joao.alves@reserva.ink>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rsv-ink/ink-hub-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/rsv-ink/ink-hub-mcp/issues"
+  },
+  "homepage": "https://github.com/rsv-ink/ink-hub-mcp#readme",
+  "main": "dist/index.js",
+  "bin": {
+    "ink-hub-mcp": "dist/index.js"
+  },
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --clean",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "prepublishOnly": "npm run test && npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "eventsource": "^4.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.2",
+    "tsup": "^8.5.1",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.5"
+  }
+}