@error-bar/mcp 0.3.0

package/dist/server.d.ts

@@ -0,0 +1,21 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ZodTypeAny } from "zod";
+import type { Operation } from "./manifest-types.js";
+import { OmniaClient } from "./client.js";
+export interface ServerOptions {
+    client: OmniaClient;
+    /** Expose only GET operations. */
+    readOnly?: boolean;
+    /** Hide operations that spend money (eval runs, training, dedicated capacity). */
+    noSpend?: boolean;
+    /** Restrict to these tool names (after the filters above). */
+    only?: string[];
+    /** Max characters of a response body returned to the model (default 60k). */
+    maxChars?: number;
+    version?: string;
+}
+/** The MCP input schema for one operation: path + query + body fields, flat. */
+export declare function inputShapeFor(op: Operation): Record<string, ZodTypeAny>;
+export declare function descriptionFor(op: Operation): string;
+export declare function selectOperations(opts: Pick<ServerOptions, "readOnly" | "noSpend" | "only">): readonly Operation[];
+export declare function createServer(opts: ServerOptions): McpServer;

package/dist/server.js

@@ -0,0 +1,135 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { OPERATIONS } from "./manifest.js";
+function zodFor(p) {
+    let t;
+    switch (p.type) {
+        case "string":
+            t = p.enum ? z.enum(p.enum) : z.string();
+            break;
+        case "integer":
+            t = z.number().int();
+            break;
+        case "number":
+            t = z.number();
+            break;
+        case "boolean":
+            t = z.boolean();
+            break;
+        case "object":
+            t = z.record(z.string(), z.unknown());
+            break;
+        case "array": {
+            const item = p.items === "integer" ? z.number().int()
+                : p.items === "number" ? z.number()
+                    : p.items === "boolean" ? z.boolean()
+                        : p.items === "object" ? z.record(z.string(), z.unknown())
+                            : z.string();
+            t = z.array(item);
+            break;
+        }
+    }
+    t = t.describe(p.description + (p.default !== undefined ? ` Default: ${JSON.stringify(p.default)}.` : ""));
+    return p.required ? t : t.optional();
+}
+/** The MCP input schema for one operation: path + query + body fields, flat. */
+export function inputShapeFor(op) {
+    const shape = {};
+    const add = (p, kind) => {
+        if (shape[p.name])
+            throw new Error(`${op.name}: duplicate parameter name ${p.name} (${kind})`);
+        shape[p.name] = zodFor(p);
+    };
+    for (const p of op.pathParams ?? [])
+        add({ ...p, required: true }, "path");
+    for (const p of op.query ?? [])
+        add(p, "query");
+    for (const p of op.body ?? [])
+        add(p, "body");
+    return shape;
+}
+export function descriptionFor(op) {
+    const parts = [op.summary];
+    parts.push(`${op.method} ${op.path} (API-key scope: ${op.scope}).`);
+    if (op.spends)
+        parts.push("SPENDS MONEY: this starts billable work on the workspace wallet.");
+    parts.push(`Returns: ${op.responseSummary}`);
+    if (op.notes)
+        parts.push(`Notes: ${op.notes}`);
+    return parts.join(" ");
+}
+export function selectOperations(opts) {
+    let ops = OPERATIONS;
+    if (opts.readOnly)
+        ops = ops.filter((o) => o.method === "GET");
+    if (opts.noSpend)
+        ops = ops.filter((o) => !o.spends);
+    if (opts.only?.length) {
+        const want = new Set(opts.only);
+        ops = ops.filter((o) => want.has(o.name));
+    }
+    return ops;
+}
+function truncate(s, max) {
+    return s.length <= max ? s : s.slice(0, max) + `\n… [truncated ${s.length - max} characters; narrow the query or use a cursor]`;
+}
+export function createServer(opts) {
+    const server = new McpServer({ name: "errorbar", version: opts.version ?? "0.0.0" });
+    const maxChars = opts.maxChars ?? 60_000;
+    for (const op of selectOperations(opts)) {
+        const pathNames = new Set((op.pathParams ?? []).map((p) => p.name));
+        const queryNames = new Set((op.query ?? []).map((p) => p.name));
+        const bodyNames = new Set((op.body ?? []).map((p) => p.name));
+        server.registerTool(op.name, {
+            title: op.name.replace(/_/g, " "),
+            description: descriptionFor(op),
+            inputSchema: inputShapeFor(op),
+            annotations: {
+                readOnlyHint: op.method === "GET",
+                destructiveHint: op.method === "DELETE",
+                idempotentHint: op.method === "GET" || op.method === "PUT" || op.method === "DELETE",
+                openWorldHint: true,
+            },
+        }, async (args) => {
+            const pathParams = {};
+            const query = {};
+            const body = {};
+            for (const [k, v] of Object.entries(args ?? {})) {
+                if (v === undefined)
+                    continue;
+                if (pathNames.has(k))
+                    pathParams[k] = v;
+                else if (queryNames.has(k))
+                    query[k] = v;
+                else if (bodyNames.has(k))
+                    body[k] = v;
+            }
+            let res;
+            try {
+                res = await opts.client.request({
+                    method: op.method,
+                    path: op.path,
+                    pathParams,
+                    query,
+                    body: bodyNames.size > 0 ? body : undefined,
+                });
+            }
+            catch (e) {
+                return { isError: true, content: [{ type: "text", text: `request failed: ${e.message}` }] };
+            }
+            let text = res.json !== undefined ? JSON.stringify(res.json, null, 2) : (res.text ?? "");
+            if (res.json === undefined && res.contentType.includes("text/html")) {
+                // An HTML body is never an API answer — it is the platform's 404/500 page
+                // (route not deployed, wrong base URL). Say that instead of dumping markup.
+                const title = /<title>([^<]*)<\/title>/i.exec(text)?.[1]?.trim();
+                text = `HTML page instead of an API response${title ? ` ("${title}")` : ""} — the route is not available at this base URL (check ERRORBAR_BASE_URL or whether this API version is deployed).`;
+            }
+            const headline = res.ok ? "" : `HTTP ${res.status} from ${op.method} ${op.path}\n`;
+            return {
+                isError: !res.ok,
+                content: [{ type: "text", text: headline + truncate(text, maxChars) }],
+            };
+        });
+    }
+    return server;
+}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@error-bar/mcp",
+  "version": "0.3.0",
+  "description": "errorbar MCP server \u2014 every platform API (evals, criteria, gates, logs, datasets, aliases, audit, proving) as tools for Claude, Cursor, and any MCP client.",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/omnia-v/omnia-mcp.git"
+  },
+  "type": "module",
+  "bin": {
+    "errorbar-mcp": "dist/cli.js",
+    "omnia-mcp": "dist/cli.js"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && chmod +x dist/cli.js",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "start": "node dist/cli.js"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0",
+    "vitest": "^3.0.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./cli": "./dist/cli.js"
+  },
+  "homepage": "https://docs.errorbar.ai"
+}