driven-research-mcp 1.0.0

package/README.md

@@ -0,0 +1,64 @@
+# driven-research-mcp
+
+A tiny **stdio ↔ HTTP bridge** for the Driven Research MCP. It speaks MCP over
+stdin/stdout locally and forwards every call to the hosted MCP endpoint with
+your API key.
+
+Use it for clients that can't add a remote HTTP MCP with a custom auth header —
+**Claude Desktop**, Codex, Cursor, and other stdio-only agents. (In **Claude
+Code** you don't need this — add the HTTP server directly with `claude mcp add
+--transport http … --header "Authorization: Bearer drk_…"`.)
+
+## Configure
+
+Set your API key (generate one at the Driven Research dashboard → Settings):
+
+- `DRIVEN_RESEARCH_API_KEY` — required, your `drk_…` key
+- `DRIVEN_RESEARCH_URL` — optional, defaults to the hosted endpoint
+
+## Claude Desktop
+
+Edit `claude_desktop_config.json` (macOS: `~/Library/Application Support/Claude/`):
+
+```json
+{
+  "mcpServers": {
+    "driven-research": {
+      "command": "npx",
+      "args": ["-y", "driven-research-mcp"],
+      "env": { "DRIVEN_RESEARCH_API_KEY": "drk_your_key" }
+    }
+  }
+}
+```
+
+Before publishing to npm, point `command`/`args` at the local file instead:
+
+```json
+{
+  "mcpServers": {
+    "driven-research": {
+      "command": "node",
+      "args": ["/absolute/path/to/mcp-client/bin.mjs"],
+      "env": { "DRIVEN_RESEARCH_API_KEY": "drk_your_key" }
+    }
+  }
+}
+```
+
+Restart Claude Desktop, then the `dr_*` tools appear.
+
+## Other stdio agents
+
+Same idea — register a stdio command `npx -y driven-research-mcp` (or
+`node bin.mjs`) with `DRIVEN_RESEARCH_API_KEY` in the environment.
+
+## Publishing (optional)
+
+```bash
+cd mcp-client
+npm publish        # requires an npm account; pick an available package name
+```
+
+Until then it works fine via the local-path config above, or
+`npx /absolute/path/to/mcp-client`.

package/bin.mjs

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+// Driven Research MCP — stdio <-> HTTP bridge.
+// Speaks MCP over stdin/stdout (newline-delimited JSON-RPC) and forwards every
+// message to the hosted MCP endpoint with the API key. Lets stdio-only clients
+// (Claude Desktop, Codex, Cursor) use the same server Claude Code reaches over HTTP.
+//
+//   DRIVEN_RESEARCH_API_KEY   required — your drk_... key
+//   DRIVEN_RESEARCH_URL       optional — defaults to the hosted endpoint
+import readline from "node:readline";
+
+const URL =
+  process.env.DRIVEN_RESEARCH_URL ||
+  "https://driven-research.vercel.app/api/mcp";
+const KEY =
+  process.env.DRIVEN_RESEARCH_API_KEY || process.env.DRIVEN_RESEARCH_KEY;
+
+if (process.argv.includes("--help") || process.argv.includes("-h")) {
+  process.stderr.write(
+    "driven-research-mcp — stdio bridge to the Driven Research MCP\n" +
+      "Set DRIVEN_RESEARCH_API_KEY (drk_...). Optional DRIVEN_RESEARCH_URL.\n",
+  );
+  process.exit(0);
+}
+if (!KEY) {
+  process.stderr.write(
+    "driven-research-mcp: missing DRIVEN_RESEARCH_API_KEY environment variable.\n",
+  );
+  process.exit(1);
+}
+
+const send = (obj) => process.stdout.write(JSON.stringify(obj) + "\n");
+
+const rl = readline.createInterface({ input: process.stdin });
+
+rl.on("line", async (line) => {
+  const text = line.trim();
+  if (!text) return;
+
+  let msg;
+  try {
+    msg = JSON.parse(text);
+  } catch {
+    return; // ignore non-JSON lines
+  }
+
+  try {
+    const res = await fetch(URL, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: "Bearer " + KEY,
+      },
+      body: JSON.stringify(msg),
+    });
+
+    // Notifications return 202 with no body — nothing to write back.
+    if (res.status === 202) return;
+
+    const data = await res.json().catch(() => null);
+    if (data == null) {
+      if (msg.id !== undefined) {
+        send({
+          jsonrpc: "2.0",
+          id: msg.id,
+          error: { code: -32603, message: "Upstream HTTP " + res.status },
+        });
+      }
+      return;
+    }
+
+    // Keep the response id aligned with the request (e.g. auth errors return id:null).
+    if (
+      msg.id !== undefined &&
+      (data.id === null || data.id === undefined)
+    ) {
+      data.id = msg.id;
+    }
+    send(data);
+  } catch (e) {
+    if (msg.id !== undefined) {
+      send({
+        jsonrpc: "2.0",
+        id: msg.id,
+        error: { code: -32603, message: String((e && e.message) || e) },
+      });
+    }
+  }
+});

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "driven-research-mcp",
+  "version": "1.0.0",
+  "description": "Driven Research MCP — stdio client that bridges to the hosted Driven Research MCP server. For Claude Desktop and other stdio-only agents.",
+  "type": "module",
+  "bin": {
+    "driven-research-mcp": "bin.mjs"
+  },
+  "files": [
+    "bin.mjs",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT"
+}