@grackle-ai/mcp-stdio 0.110.1

package/README.md

@@ -0,0 +1,79 @@
+# @grackle-ai/mcp-stdio
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@grackle-ai/mcp-stdio"><img src="https://img.shields.io/npm/v/@grackle-ai/mcp-stdio.svg" alt="npm version" /></a>
+  <a href="https://github.com/nick-pape/grackle/actions/workflows/ci.yml"><img src="https://github.com/nick-pape/grackle/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI" /></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT" /></a>
+</p>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/nick-pape/grackle/main/apps/docs-site/static/img/grackle-logo.png" alt="Grackle" width="200" />
+</p>
+
+stdio-to-HTTP MCP proxy for [Grackle](https://github.com/nick-pape/grackle). Bridges MCP clients that only speak stdio (Claude Desktop, Codex CLI, Clawpilot) to a running Grackle HTTP MCP server using static API-key auth — no OAuth flow required.
+
+## Quick Start
+
+Add to your MCP client config:
+
+```json
+{
+  "grackle": {
+    "command": "npx",
+    "args": ["-y", "@grackle-ai/mcp-stdio"],
+    "env": {
+      "GRACKLE_URL": "http://127.0.0.1:7435/mcp",
+      "GRACKLE_API_KEY": "<your-api-key>"
+    }
+  }
+}
+```
+
+Or run directly:
+
+```bash
+GRACKLE_URL=http://127.0.0.1:7435/mcp GRACKLE_API_KEY=<key> npx @grackle-ai/mcp-stdio
+```
+
+Requires **Node.js >= 22**.
+
+## Configuration
+
+| Variable | Description | Default |
+| --- | --- | --- |
+| `GRACKLE_URL` | Full URL of the Grackle MCP HTTP endpoint | `http://127.0.0.1:7435/mcp` |
+| `GRACKLE_API_KEY` | API key for authenticating with the Grackle server. **Required** — the proxy exits with an error if not set. | *(none)* |
+
+The API key is the 64-character hex token stored in `~/.grackle/api-key` on the machine running the Grackle server. For a Docker deployment, see the section below.
+
+---
+
+## Docker Quick Start
+
+The published Grackle image exposes the MCP port (7435) by default when using the provided `docker-compose.yml`:
+
+```bash
+# Start Grackle
+docker compose up -d
+
+# Read the API key from the container's volume
+docker exec grackle cat /data/.grackle/api-key
+```
+
+Then use the key in your MCP client config as shown above, with `GRACKLE_URL=http://127.0.0.1:7435/mcp`.
+
+> **Multi-tenant hosts:** The default `docker-compose.yml` binding exposes port 7435 on all interfaces. To restrict to loopback, change the port mapping to `"127.0.0.1:7435:7435"` in your compose file.
+
+---
+
+## How It Works
+
+`@grackle-ai/mcp-stdio` spawns a local stdio MCP server that forwards every `tools/list` and `tools/call` request to the Grackle HTTP MCP server over Streamable HTTP. Tool discovery is fully dynamic — the proxy calls `listTools` upstream on every request so new Grackle tools are automatically available without updating the proxy.
+
+On any network error the proxy reconnects once before propagating the failure. No OAuth flow, no token expiry.
+
+---
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { main } from "./proxy.js";
+main().catch((err) => {
+    process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAElC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACrF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/proxy.d.ts

@@ -0,0 +1,32 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+/** Create a fresh upstream transport pointing at the Grackle HTTP MCP server. */
+export declare function newTransport(grackleUrl: string, apiKey: string): StreamableHTTPClientTransport;
+/** Manages the upstream client as a promise to avoid async assignment races. */
+export interface ClientManager {
+    getClient: () => Promise<Client>;
+    resetClient: () => void;
+}
+/** Create a ClientManager that lazily connects and reconnects on demand. */
+export declare function createClientManager(grackleUrl: string, apiKey: string): ClientManager;
+/**
+ * Returns true for errors that indicate a transient transport or connectivity
+ * failure and are safe to retry without risk of duplicating side effects.
+ * Application-level errors (e.g. invalid tool arguments) are not transport
+ * errors and should propagate immediately without a retry.
+ * Exported for testability.
+ */
+export declare function isTransportError(err: unknown): boolean;
+/**
+ * Call `fn` with the upstream client, reconnecting once on transient transport
+ * errors. Non-transport errors (application errors, tool errors) propagate
+ * immediately without retry to avoid duplicating side effects.
+ * Exported for testability.
+ */
+export declare function withReconnect<T>(manager: ClientManager, fn: (c: Client) => Promise<T>): Promise<T>;
+/** Create the stdio MCP server that proxies all requests to the Grackle HTTP MCP server. */
+export declare function createProxyServer(grackleUrl: string, apiKey: string): Server;
+/** Start the proxy: connect upstream, then attach to stdio and serve. */
+export declare function main(): Promise<void>;
+//# sourceMappingURL=proxy.d.ts.map

package/dist/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAcnE,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,6BAA6B,CAI9F;AAWD,gFAAgF;AAChF,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACjC,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAsBrF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAiBtD;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,CAAC,EACnC,OAAO,EAAE,aAAa,EACtB,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAC5B,OAAO,CAAC,CAAC,CAAC,CAYZ;AAED,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAsB5E;AAED,yEAAyE;AACzE,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAiB1C"}

package/dist/proxy.js

@@ -0,0 +1,117 @@
+import { createRequire } from "node:module";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { ListToolsRequestSchema, CallToolRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+const esmRequire = createRequire(import.meta.url);
+const { version } = esmRequire("../package.json");
+/** Default MCP HTTP endpoint when GRACKLE_URL is not set. */
+const DEFAULT_GRACKLE_URL = "http://127.0.0.1:7435/mcp";
+/** Create a fresh upstream transport pointing at the Grackle HTTP MCP server. */
+export function newTransport(grackleUrl, apiKey) {
+    return new StreamableHTTPClientTransport(new URL(grackleUrl), {
+        requestInit: { headers: { Authorization: `Bearer ${apiKey}` } },
+    });
+}
+/** Create and connect a new upstream MCP client. */
+function connect(grackleUrl, apiKey) {
+    const c = new Client({ name: "grackle-mcp-stdio", version }, { capabilities: {} });
+    return c.connect(newTransport(grackleUrl, apiKey)).then(() => c);
+}
+/** Create a ClientManager that lazily connects and reconnects on demand. */
+export function createClientManager(grackleUrl, apiKey) {
+    let upstreamPromise;
+    function getClient() {
+        if (!upstreamPromise) {
+            // Assign synchronously so concurrent callers share the same promise.
+            // On failure, clear so the next call retries.
+            upstreamPromise = connect(grackleUrl, apiKey).catch((err) => {
+                upstreamPromise = undefined;
+                throw err;
+            });
+        }
+        return upstreamPromise;
+    }
+    function resetClient() {
+        const old = upstreamPromise;
+        upstreamPromise = undefined;
+        old?.then((c) => c.close()).catch(() => { });
+    }
+    return { getClient, resetClient };
+}
+/**
+ * Returns true for errors that indicate a transient transport or connectivity
+ * failure and are safe to retry without risk of duplicating side effects.
+ * Application-level errors (e.g. invalid tool arguments) are not transport
+ * errors and should propagate immediately without a retry.
+ * Exported for testability.
+ */
+export function isTransportError(err) {
+    if (err instanceof TypeError) {
+        return true;
+    }
+    if (err instanceof Error) {
+        const msg = err.message;
+        return (msg.includes("ECONNREFUSED") ||
+            msg.includes("ECONNRESET") ||
+            msg.includes("ENOTFOUND") ||
+            msg.includes("fetch failed") ||
+            msg.includes("Failed to fetch") ||
+            msg.includes("socket hang up") ||
+            msg.includes("network"));
+    }
+    return false;
+}
+/**
+ * Call `fn` with the upstream client, reconnecting once on transient transport
+ * errors. Non-transport errors (application errors, tool errors) propagate
+ * immediately without retry to avoid duplicating side effects.
+ * Exported for testability.
+ */
+export async function withReconnect(manager, fn) {
+    try {
+        return await fn(await manager.getClient());
+    }
+    catch (err) {
+        if (!isTransportError(err)) {
+            throw err;
+        }
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`Reconnecting upstream: ${msg}\n`);
+        manager.resetClient();
+        return fn(await manager.getClient());
+    }
+}
+/** Create the stdio MCP server that proxies all requests to the Grackle HTTP MCP server. */
+export function createProxyServer(grackleUrl, apiKey) {
+    const manager = createClientManager(grackleUrl, apiKey);
+    const server = new Server({ name: "grackle-mcp-stdio", version }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        const result = await withReconnect(manager, (c) => c.listTools());
+        return { tools: result.tools };
+    });
+    server.setRequestHandler(CallToolRequestSchema, async (req) => {
+        const { name, arguments: args } = req.params;
+        return withReconnect(manager, (c) => c.callTool({ name, arguments: args }));
+    });
+    return server;
+}
+/** Start the proxy: connect upstream, then attach to stdio and serve. */
+export async function main() {
+    const grackleUrl = process.env.GRACKLE_URL ?? DEFAULT_GRACKLE_URL;
+    const apiKey = process.env.GRACKLE_API_KEY;
+    if (!apiKey) {
+        process.stderr.write("ERROR: GRACKLE_API_KEY is not set\n");
+        process.exit(1);
+    }
+    const server = createProxyServer(grackleUrl, apiKey);
+    await server.connect(new StdioServerTransport());
+    process.stderr.write(`grackle-mcp-stdio ready (upstream: ${grackleUrl})\n`);
+    function shutdown() {
+        process.exit(0);
+    }
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+}
+//# sourceMappingURL=proxy.js.map

package/dist/proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.js","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@grackle-ai/mcp-stdio",
+  "version": "0.110.1",
+  "description": "stdio-to-HTTP MCP proxy for Grackle — bridges stdio-only MCP clients (Claude Desktop, Codex CLI, Clawpilot) to a Grackle HTTP MCP server using static API-key auth",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nick-pape/grackle.git",
+    "directory": "packages/mcp-stdio"
+  },
+  "keywords": [
+    "grackle",
+    "mcp",
+    "model-context-protocol",
+    "stdio",
+    "proxy",
+    "ai-agents"
+  ],
+  "homepage": "https://github.com/nick-pape/grackle#readme",
+  "bugs": {
+    "url": "https://github.com/nick-pape/grackle/issues"
+  },
+  "engines": {
+    "node": ">=22.0.0 <24.0.0"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "grackle-mcp-stdio": "dist/index.js"
+  },
+  "files": [
+    "dist/"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.0"
+  },
+  "devDependencies": {
+    "@rushstack/heft": "1.2.7",
+    "@types/node": "^22.0.0",
+    "vitest": "^3.1.1",
+    "@grackle-ai/heft-rig": "0.0.1"
+  },
+  "scripts": {
+    "build": "heft build --clean",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "clean": "heft clean",
+    "_phase:build": "heft run --only build -- --clean",
+    "_phase:test": "vitest run"
+  }
+}