rentbamboo-mcp 0.1.0

package/README.md

@@ -0,0 +1,73 @@
+# rentbamboo-mcp
+
+A zero-dependency [MCP](https://modelcontextprotocol.io) **stdio bridge** for
+RentBamboo. It connects any local AI agent (Claude Desktop, Cursor, VS Code,
+PI, opm) to the hosted RentBamboo MCP server over Streamable HTTP using your
+API key. The 55 Panda tools it exposes are **read-only** right now.
+
+## Install
+
+```bash
+npm install -g rentbamboo-mcp
+```
+
+## Configure
+
+Set your API key (get one in RentBamboo → Settings → MCP → API keys):
+
+```bash
+export RENTBAMBOO_API_KEY=rb_live_...
+```
+
+Optionally point at a non-production endpoint:
+
+```bash
+export RENTBAMBOO_MCP_URL=http://localhost:3000/api/mcp
+```
+
+## Usage
+
+For **Claude Desktop / Cursor / VS Code** (`claude_desktop_config.json`,
+`mcp.json`, etc.):
+
+```json
+{
+  "mcpServers": {
+    "rentbamboo": {
+      "command": "rentbamboo-mcp",
+      "env": { "RENTBAMBOO_API_KEY": "rb_live_..." }
+    }
+  }
+}
+```
+
+For **opm** (`~/.omp/agent/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "rentbamboo": {
+      "type": "stdio",
+      "command": "rentbamboo-mcp",
+      "env": { "RENTBAMBOO_API_KEY": "rb_live_..." }
+    }
+  }
+}
+```
+
+For **PI**, install the adapter first (`pi install npm:pi-mcp-adapter`), then
+point it at `rentbamboo-mcp` the same way.
+
+## How it works
+
+`rentbamboo-mcp` reads JSON-RPC frames from stdin and forwards each one to the
+hosted MCP endpoint (`POST https://rentbamboo.com/api/mcp`) with
+`Authorization: Bearer <key>`, then writes the response back to stdout. It is a
+thin proxy — all tools, permissions, and the read-only gate live server-side.
+
+## Environment
+
+| Variable              | Required | Default                          |
+| --------------------- | -------- | -------------------------------- |
+| `RENTBAMBOO_API_KEY`  | yes      | —                                |
+| `RENTBAMBOO_MCP_URL`  | no       | `https://rentbamboo.com/api/mcp` |

package/cli.js

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+/**
+ * rentbamboo-mcp — stdio↔HTTP MCP bridge for RentBamboo.
+ *
+ * A zero-dependency bridge: it presents a stdio MCP server to any local AI
+ * agent (Claude Desktop, PI, opm, Cursor, VS Code) and forwards every JSON-RPC
+ * request to the hosted RentBamboo MCP endpoint (Streamable HTTP) using your
+ * API key. The actual tools/tool-execution live on the hosted server; this
+ * package just proxies the wire protocol.
+ *
+ * Env:
+ *   RENTBAMBOO_API_KEY   (required)  your rb_live_... / rb_test_... key
+ *   RENTBAMBOO_MCP_URL   (optional)  default https://rentbamboo.com/api/mcp
+ */
+
+import { createInterface } from "node:readline";
+
+const DEFAULT_URL = "https://rentbamboo.com/api/mcp";
+const URL = process.env.RENTBAMBOO_MCP_URL || DEFAULT_URL;
+const KEY = process.env.RENTBAMBOO_API_KEY || process.env.RENTBAMBOO_MCP_KEY || "";
+
+if (!KEY) {
+	console.error(
+		"[rentbamboo-mcp] Set RENTBAMBOO_API_KEY to your RentBamboo API key (rb_live_...).",
+	);
+	process.exit(1);
+}
+
+/** Build a JSON-RPC error envelope for an upstream failure. */
+function errorResponse(id, message) {
+	return { jsonrpc: "2.0", id: id ?? null, error: { code: -32603, message } };
+}
+
+async function forward(message) {
+	const id = Array.isArray(message) ? null : message?.id ?? null;
+	try {
+		const res = await fetch(URL, {
+			method: "POST",
+			headers: {
+				"Content-Type": "application/json",
+				Accept: "application/json",
+				Authorization: `Bearer ${KEY}`,
+			},
+			body: typeof message === "string" ? message : JSON.stringify(message),
+			signal: AbortSignal.timeout(120_000),
+		});
+		const text = await res.text();
+		if (res.ok) {
+			if (!text) return null; // notification (202 empty) — no reply
+			try {
+				return JSON.parse(text);
+			} catch {
+				return errorResponse(id, `invalid upstream response (${text.slice(0, 120)})`);
+			}
+		}
+		return errorResponse(id, `upstream ${res.status}: ${text.slice(0, 200)}`);
+	} catch (err) {
+		return errorResponse(id, `upstream unreachable: ${err?.message ?? "network error"}`);
+	}
+}
+
+// Serialize forwards so stdout responses stay in request order, and keep the
+// process alive until every in-flight forward has settled (even if stdin
+// closes — otherwise a piped/short-lived input would exit before the reply).
+let pending = Promise.resolve();
+
+const rl = createInterface({ input: process.stdin, crlfDelay: Infinity });
+rl.on("line", (line) => {
+	const trimmed = line.trim();
+	if (!trimmed) return;
+	let message;
+	try {
+		message = JSON.parse(trimmed);
+	} catch {
+		return; // malformed frame — ignore
+	}
+	pending = pending.then(async () => {
+		const result = await forward(message);
+		if (result !== null && result !== undefined) {
+			process.stdout.write(JSON.stringify(result) + "\n");
+		}
+	});
+});
+rl.on("close", async () => {
+	await pending;
+	process.exit(0);
+});

package/package.json

@@ -0,0 +1,19 @@
+{
+	"name": "rentbamboo-mcp",
+	"version": "0.1.0",
+	"description": "Stdio MCP bridge to the RentBamboo MCP server. Exposes the RentBamboo Panda tools (read-only) to any MCP-capable AI agent.",
+	"type": "module",
+	"bin": {
+		"rentbamboo-mcp": "cli.js"
+	},
+	"main": "cli.js",
+	"files": ["cli.js", "README.md"],
+	"engines": {
+		"node": ">=18"
+	},
+	"keywords": ["mcp", "rentbamboo", "crm", "pm", "ai", "agent", "panda"],
+	"license": "MIT",
+	"publishConfig": {
+		"access": "public"
+	}
+}