@pacerelle/mcp-server 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pacerelle
+
+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,82 @@
+# Pacerelle MCP Server
+
+MCP server for Pacerelle encrypted local agent relays.
+
+Run it from any MCP-compatible client that can spawn a local stdio server, such
+as Claude Desktop, Cursor, Zed, or other MCP hosts.
+
+## Install
+
+```bash
+npx -y @pacerelle/mcp-server
+```
+
+## Configuration
+
+Create an agent in Pacerelle, copy its id and token, then expose them to the MCP
+process:
+
+```env
+PACERELLE_AGENT_ID=agent_...
+PACERELLE_AGENT_TOKEN=...
+```
+
+The published package connects to `https://api.pacerelle.com` by default. For
+local development, set:
+
+```env
+PACERELLE_BASE_URL=http://localhost:8080
+```
+
+Optional:
+
+```env
+PACERELLE_WS_URL=ws://localhost:8080
+PACERELLE_STORE_ROOT=.pacerelle/mcp
+```
+
+## Claude Desktop Example
+
+```json
+{
+  "mcpServers": {
+    "pacerelle": {
+      "command": "npx",
+      "args": ["-y", "@pacerelle/mcp-server"],
+      "env": {
+        "PACERELLE_AGENT_ID": "agent_...",
+        "PACERELLE_AGENT_TOKEN": "..."
+      }
+    }
+  }
+}
+```
+
+## Tools
+
+- `send_message`: send an encrypted text reply to the current or provided conversation.
+- `send_widget`: send a `widget.standard` v1 payload.
+- `get_history`: return recent plaintext messages observed by this MCP process.
+
+## Resources
+
+- `conversation://current`: most recent conversation message seen by this process.
+- `widget://pending`: latest widget response observed by this process.
+
+## CLI
+
+Environment variables are recommended, but explicit flags are supported:
+
+```bash
+pacerelle-mcp \
+  --agent-id "$PACERELLE_AGENT_ID" \
+  --token "$PACERELLE_AGENT_TOKEN"
+```
+
+Local development:
+
+```bash
+pacerelle-mcp \
+  --base-url "http://localhost:8080" \
+  --ws-url "ws://localhost:8080"
+```

package/dist/bridge.d.ts

@@ -0,0 +1,38 @@
+import type { AgentGatewayClient, AgentMessage } from "@pacerelle/sdk";
+export interface MessageSender {
+    sendMessage(options: {
+        conversationId: string;
+        to: string;
+        text: string;
+        replyToMessageId?: string;
+    }): Promise<void>;
+}
+export declare class PacerelleMcpBridge {
+    private readonly client;
+    private readonly historyLimit;
+    private readonly messages;
+    private current;
+    private pendingWidget;
+    constructor(client: MessageSender, historyLimit?: number);
+    recordMessage(message: AgentMessage): void;
+    sendMessage(args: {
+        text: string;
+        conversationId?: string;
+        to?: string;
+        replyToMessageId?: string;
+    }): Promise<Record<string, unknown>>;
+    sendWidget(args: {
+        widgetJson: string | Record<string, unknown>;
+        conversationId?: string;
+        to?: string;
+    }): Promise<Record<string, unknown>>;
+    getHistory(args: {
+        conversationId?: string;
+        limit?: number;
+    }): Array<Record<string, unknown>>;
+    currentConversation(): Record<string, unknown>;
+    pendingWidgetResponse(): Record<string, unknown>;
+    attach(client: AgentGatewayClient): void;
+    private requireCurrent;
+    private parseWidget;
+}

package/dist/bridge.js

@@ -0,0 +1,109 @@
+export class PacerelleMcpBridge {
+    client;
+    historyLimit;
+    messages = [];
+    current = null;
+    pendingWidget = null;
+    constructor(client, historyLimit = 50) {
+        this.client = client;
+        this.historyLimit = historyLimit;
+    }
+    recordMessage(message) {
+        const item = {
+            id: message.id,
+            conversation_id: message.conversationId,
+            from: message.from,
+            text: message.text,
+            encrypted: message.encrypted,
+            reply_to_message_id: message.replyToMessageId ?? null,
+            attachments: message.attachments ?? [],
+            widget_response: message.widgetResponse ?? null,
+            widget_update: message.widgetUpdate ?? null,
+        };
+        this.messages.push(item);
+        while (this.messages.length > this.historyLimit)
+            this.messages.shift();
+        this.current = item;
+        if (message.widgetResponse) {
+            this.pendingWidget = {
+                type: "widget.response",
+                id: message.widgetResponse.id,
+                ref: message.widgetResponse.ref,
+                value: message.widgetResponse.value,
+                cancelled: message.widgetResponse.cancelled,
+                conversation_id: message.conversationId,
+                from: message.from,
+            };
+        }
+    }
+    async sendMessage(args) {
+        const current = this.requireCurrent(args.conversationId, args.to);
+        const conversationId = args.conversationId ?? String(current.conversation_id);
+        const to = args.to ?? String(current.from);
+        await this.client.sendMessage({
+            conversationId,
+            to,
+            text: args.text,
+            replyToMessageId: args.replyToMessageId,
+        });
+        return { ok: true, conversation_id: conversationId, to };
+    }
+    async sendWidget(args) {
+        const widget = this.parseWidget(args.widgetJson);
+        const current = this.requireCurrent(args.conversationId, args.to);
+        const conversationId = args.conversationId ?? String(current.conversation_id);
+        const to = args.to ?? String(current.from);
+        await this.client.sendMessage({
+            conversationId,
+            to,
+            text: JSON.stringify(widget),
+        });
+        return {
+            ok: true,
+            widget_id: widget.id,
+            kind: widget.kind,
+            conversation_id: conversationId,
+            to,
+        };
+    }
+    getHistory(args) {
+        const limit = Math.max(1, Math.min(args.limit ?? 50, this.historyLimit));
+        const scoped = args.conversationId
+            ? this.messages.filter((message) => message.conversation_id === args.conversationId)
+            : this.messages;
+        return scoped.slice(-limit);
+    }
+    currentConversation() {
+        return this.current ?? { status: "empty" };
+    }
+    pendingWidgetResponse() {
+        return this.pendingWidget ?? { status: "empty" };
+    }
+    attach(client) {
+        client.onMessage((message) => this.recordMessage(message));
+    }
+    requireCurrent(conversationId, to) {
+        if (conversationId && to)
+            return {};
+        if (this.current)
+            return this.current;
+        throw new Error("No current conversation. Wait for an inbound Pacerelle message or pass conversationId and to.");
+    }
+    parseWidget(widgetJson) {
+        const widget = typeof widgetJson === "string" ? JSON.parse(widgetJson) : widgetJson;
+        if (!widget || typeof widget !== "object" || Array.isArray(widget)) {
+            throw new Error("widgetJson must be an object");
+        }
+        if (widget.type !== "widget.standard" || widget.v !== 1) {
+            throw new Error("widgetJson must be a widget.standard v1 payload");
+        }
+        if (typeof widget.id !== "string" || typeof widget.kind !== "string") {
+            throw new Error("widgetJson requires string id and kind");
+        }
+        if (!widget.spec || typeof widget.spec !== "object" || Array.isArray(widget.spec)) {
+            throw new Error("widgetJson requires spec object");
+        }
+        return widget;
+    }
+}
+//# sourceMappingURL=bridge.js.map

package/dist/bridge.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { AgentGatewayClient } from "@pacerelle/sdk";
+import { PacerelleMcpBridge } from "./bridge.js";
+import { createPacerelleMcpServer } from "./server.js";
+const defaultBaseUrl = "https://api.pacerelle.com";
+async function main() {
+    const options = parseArgs(process.argv.slice(2));
+    if (!options.token || !options.agentId) {
+        throw new Error("PACERELLE_AGENT_ID and PACERELLE_AGENT_TOKEN are required.");
+    }
+    const snapshotPath = join(options.storeRoot, `${options.agentId}.signal.snapshot`);
+    const signalSnapshot = existsSync(snapshotPath) ? await readFile(snapshotPath) : undefined;
+    const wasm = readFileSync(resolveSdkWasmPath());
+    const client = new AgentGatewayClient({
+        token: options.token,
+        agentId: options.agentId,
+        baseUrl: options.baseUrl,
+        wsUrl: options.wsUrl,
+        e2ee: options.e2ee,
+        wasm,
+        signalSnapshot,
+        onSignalSnapshot: async (snapshot) => {
+            await mkdir(dirname(snapshotPath), { recursive: true });
+            await writeFile(snapshotPath, snapshot);
+        },
+        onOpen: () => {
+            console.error("Pacerelle MCP connected.");
+        },
+        onError: (error) => {
+            console.error("Pacerelle MCP agent error:", error);
+        },
+    });
+    const bridge = new PacerelleMcpBridge(client);
+    bridge.attach(client);
+    await client.connect();
+    const server = createPacerelleMcpServer(bridge);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    const shutdown = async () => {
+        client.close();
+        await server.close();
+        process.exit(0);
+    };
+    process.once("SIGINT", () => void shutdown());
+    process.once("SIGTERM", () => void shutdown());
+}
+function parseArgs(args) {
+    const values = new Map();
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (!arg.startsWith("--"))
+            continue;
+        const key = arg.slice(2);
+        if (key === "no-e2ee") {
+            values.set(key, true);
+            continue;
+        }
+        const next = args[index + 1];
+        if (!next || next.startsWith("--")) {
+            throw new Error(`Missing value for --${key}`);
+        }
+        values.set(key, next);
+        index += 1;
+    }
+    return {
+        token: stringValue(values, "token") ?? process.env.PACERELLE_AGENT_TOKEN,
+        agentId: stringValue(values, "agent-id") ?? process.env.PACERELLE_AGENT_ID,
+        baseUrl: stringValue(values, "base-url") ?? process.env.PACERELLE_BASE_URL ?? defaultBaseUrl,
+        wsUrl: stringValue(values, "ws-url") ?? process.env.PACERELLE_WS_URL,
+        storeRoot: stringValue(values, "store-root") ??
+            process.env.PACERELLE_STORE_ROOT ??
+            join(process.env.HOME ?? process.env.USERPROFILE ?? ".", ".pacerelle", "mcp"),
+        e2ee: !values.has("no-e2ee"),
+    };
+}
+function stringValue(values, key) {
+    const value = values.get(key);
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function resolveSdkWasmPath() {
+    const sdkEntry = fileURLToPath(import.meta.resolve("@pacerelle/sdk"));
+    return join(dirname(sdkEntry), "signal-wasm", "signalwrap_bg.wasm");
+}
+main().catch((error) => {
+    console.error(error instanceof Error ? error.message : error);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { PacerelleMcpBridge } from "./bridge.js";
+export declare const version = "0.1.0-alpha.0";
+export declare function createPacerelleMcpServer(bridge: PacerelleMcpBridge): McpServer;

package/dist/server.js

@@ -0,0 +1,79 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+export const version = "0.1.0-alpha.0";
+export function createPacerelleMcpServer(bridge) {
+    const server = new McpServer({
+        name: "pacerelle-mcp",
+        version,
+    });
+    server.registerTool("send_message", {
+        title: "Send Message",
+        description: "Send an encrypted message to the current or provided Pacerelle conversation.",
+        inputSchema: {
+            text: z.string(),
+            conversationId: z.string().optional(),
+            to: z.string().optional(),
+            replyToMessageId: z.string().optional(),
+        },
+    }, async ({ text, conversationId, to, replyToMessageId }) => {
+        const result = await bridge.sendMessage({ text, conversationId, to, replyToMessageId });
+        return {
+            content: [{ type: "text", text: JSON.stringify(result) }],
+        };
+    });
+    server.registerTool("send_widget", {
+        title: "Send Widget",
+        description: "Send a widget.standard v1 JSON payload to the current or provided Pacerelle conversation.",
+        inputSchema: {
+            widgetJson: z.union([z.string(), z.record(z.string(), z.unknown())]),
+            conversationId: z.string().optional(),
+            to: z.string().optional(),
+        },
+    }, async ({ widgetJson, conversationId, to }) => {
+        const result = await bridge.sendWidget({ widgetJson, conversationId, to });
+        return {
+            content: [{ type: "text", text: JSON.stringify(result) }],
+        };
+    });
+    server.registerTool("get_history", {
+        title: "Get History",
+        description: "Return recent plaintext messages observed by this MCP process in memory.",
+        inputSchema: {
+            conversationId: z.string().optional(),
+            limit: z.number().int().min(1).max(50).optional(),
+        },
+    }, async ({ conversationId, limit }) => ({
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(bridge.getHistory({ conversationId, limit })),
+            },
+        ],
+    }));
+    server.registerResource("current-conversation", "conversation://current", {
+        title: "Current Pacerelle conversation",
+        mimeType: "application/json",
+    }, async (uri) => ({
+        contents: [
+            {
+                uri: uri.href,
+                mimeType: "application/json",
+                text: JSON.stringify(bridge.currentConversation()),
+            },
+        ],
+    }));
+    server.registerResource("pending-widget-response", "widget://pending", {
+        title: "Last widget response observed by Pacerelle",
+        mimeType: "application/json",
+    }, async (uri) => ({
+        contents: [
+            {
+                uri: uri.href,
+                mimeType: "application/json",
+                text: JSON.stringify(bridge.pendingWidgetResponse()),
+            },
+        ],
+    }));
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src-js/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,CAAC,MAAM,OAAO,GAAG,eAAe,CAAC;AAEvC,MAAM,UAAU,wBAAwB,CAAC,MAA0B;IACjE,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,eAAe;QACrB,OAAO;KACR,CAAC,CAAC;IAEH,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,8EAA8E;QAC3F,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACrC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACzB,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SACxC;KACF,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,gBAAgB,EAAE,EAAE,EAAE;QACvD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,gBAAgB,EAAE,CAAC,CAAC;QACxF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;SAC1D,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,2FAA2F;QACxG,WAAW,EAAE;YACX,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACpE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACrC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC1B;KACF,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,cAAc,EAAE,EAAE,EAAE,EAAE,EAAE;QAC3C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,UAAU,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,CAAC;QAC3E,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;SAC1D,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,0EAA0E;QACvF,WAAW,EAAE;YACX,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACrC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;SAClD;KACF,EACD,KAAK,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QACpC,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC;aACnE;SACF;KACF,CAAC,CACH,CAAC;IAEF,MAAM,CAAC,gBAAgB,CACrB,sBAAsB,EACtB,wBAAwB,EACxB;QACE,KAAK,EAAE,gCAAgC;QACvC,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QACd,QAAQ,EAAE;YACR;gBACE,GAAG,EAAE,GAAG,CAAC,IAAI;gBACb,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;aACnD;SACF;KACF,CAAC,CACH,CAAC;IAEF,MAAM,CAAC,gBAAgB,CACrB,yBAAyB,EACzB,kBAAkB,EAClB;QACE,KAAK,EAAE,4CAA4C;QACnD,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QACd,QAAQ,EAAE;YACR;gBACE,GAAG,EAAE,GAAG,CAAC,IAAI;gBACb,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,qBAAqB,EAAE,CAAC;aACrD;SACF;KACF,CAAC,CACH,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@pacerelle/mcp-server",
+  "version": "0.1.0-alpha.0",
+  "type": "module",
+  "description": "MCP server for Pacerelle encrypted local agent relays.",
+  "bin": {
+    "pacerelle-mcp": "./dist/cli.js"
+  },
+  "main": "./dist/cli.js",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "build:release": "node scripts/build-release.mjs",
+    "lint": "tsc --noEmit",
+    "test": "node --test"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@pacerelle/sdk": "^0.1.0-alpha.0",
+    "zod": "^4.2.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}