@apicity/mcp-server 0.1.0-alpha.0

package/dist/src/schema.js

@@ -0,0 +1,151 @@
+// Minimal Zod 3 → JSON Schema converter. We deliberately do not import zod —
+// providers ship with zod ^3.24 as a peer dep, and we read the schema's
+// internal `_def` at runtime via duck-typing. Anything we can't recognize
+// degrades to `{}` (any JSON value), which is still useful documentation.
+function isZodLike(x) {
+    return (typeof x === "object" &&
+        x !== null &&
+        "_def" in x);
+}
+export function zodToJsonSchema(schema) {
+    if (!isZodLike(schema))
+        return {};
+    const def = schema._def;
+    if (!def)
+        return {};
+    const desc = schema.description || def.description
+        ? { description: schema.description ?? def.description }
+        : {};
+    switch (def.typeName) {
+        case "ZodObject": {
+            const shape = typeof def.shape === "function" ? def.shape() : {};
+            const properties = {};
+            const required = [];
+            for (const [key, val] of Object.entries(shape)) {
+                properties[key] = zodToJsonSchema(val);
+                if (!isOptional(val))
+                    required.push(key);
+            }
+            return {
+                type: "object",
+                properties,
+                ...(required.length > 0 ? { required } : {}),
+                ...desc,
+            };
+        }
+        case "ZodString": {
+            const out = { type: "string", ...desc };
+            for (const c of def.checks ?? []) {
+                if (c.kind === "min")
+                    out.minLength = c.value;
+                if (c.kind === "max")
+                    out.maxLength = c.value;
+                if (c.kind === "url")
+                    out.format = "uri";
+                if (c.kind === "email")
+                    out.format = "email";
+                if (c.kind === "regex" && c.regex)
+                    out.pattern = c.regex.source;
+            }
+            return out;
+        }
+        case "ZodNumber": {
+            const out = { type: "number", ...desc };
+            let isInt = false;
+            for (const c of def.checks ?? []) {
+                if (c.kind === "int")
+                    isInt = true;
+                if (c.kind === "min")
+                    out.minimum = c.value;
+                if (c.kind === "max")
+                    out.maximum = c.value;
+            }
+            if (isInt)
+                out.type = "integer";
+            return out;
+        }
+        case "ZodBigInt":
+            return { type: "integer", ...desc };
+        case "ZodBoolean":
+            return { type: "boolean", ...desc };
+        case "ZodNull":
+            return { type: "null", ...desc };
+        case "ZodArray":
+            return { type: "array", items: zodToJsonSchema(def.type), ...desc };
+        case "ZodTuple":
+            return {
+                type: "array",
+                items: (def.options ?? []).map((o) => zodToJsonSchema(o)),
+                ...desc,
+            };
+        case "ZodEnum":
+        case "ZodNativeEnum": {
+            const values = Array.isArray(def.values)
+                ? def.values
+                : Object.values(def.values ?? {});
+            return { type: "string", enum: values, ...desc };
+        }
+        case "ZodLiteral":
+            return { const: def.value, ...desc };
+        case "ZodUnion":
+        case "ZodDiscriminatedUnion":
+            return {
+                anyOf: (def.options ?? []).map((o) => zodToJsonSchema(o)),
+                ...desc,
+            };
+        case "ZodIntersection": {
+            const left = zodToJsonSchema(def.left);
+            const right = zodToJsonSchema(def.right);
+            return { allOf: [left, right], ...desc };
+        }
+        case "ZodOptional":
+        case "ZodNullable":
+        case "ZodReadonly":
+        case "ZodBranded":
+            return { ...zodToJsonSchema(def.innerType), ...desc };
+        case "ZodDefault":
+            return {
+                ...zodToJsonSchema(def.innerType),
+                default: def.defaultValue?.(),
+                ...desc,
+            };
+        case "ZodEffects":
+            return { ...zodToJsonSchema(def.schema), ...desc };
+        case "ZodRecord":
+            return {
+                type: "object",
+                additionalProperties: zodToJsonSchema(def.valueType),
+                ...desc,
+            };
+        case "ZodMap":
+            return {
+                type: "object",
+                additionalProperties: zodToJsonSchema(def.valueType),
+                ...desc,
+            };
+        case "ZodAny":
+        case "ZodUnknown":
+            return { ...desc };
+        case "ZodNever":
+            return { not: {}, ...desc };
+        case "ZodVoid":
+        case "ZodUndefined":
+            return { type: "null", ...desc };
+        case "ZodPipeline":
+            return zodToJsonSchema(def.in);
+        default:
+            return { ...desc };
+    }
+}
+function isOptional(schema) {
+    if (!isZodLike(schema))
+        return true;
+    const t = schema._def?.typeName;
+    if (t === "ZodOptional" || t === "ZodDefault")
+        return true;
+    if ((t === "ZodNullable" || t === "ZodReadonly") && schema._def?.innerType) {
+        return isOptional(schema._def.innerType);
+    }
+    return false;
+}
+//# sourceMappingURL=schema.js.map

package/dist/src/schema.js.map

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

package/dist/src/server.d.ts

@@ -0,0 +1,8 @@
+export interface StartServerOptions {
+    outputDir?: string;
+    enabledProviders?: string[];
+    name?: string;
+    version?: string;
+}
+export declare function startServer(opts?: StartServerOptions): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/src/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,WAAW,CAC/B,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAyCf"}

package/dist/src/server.js

@@ -0,0 +1,140 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { buildRegistry } from "./registry.js";
+import { zodToJsonSchema } from "./schema.js";
+import { downloadUrlsInResult, guessExtension, isBinary, writeBinary, } from "./output.js";
+export async function startServer(opts = {}) {
+    const endpoints = await buildRegistry({
+        enabledProviders: opts.enabledProviders,
+    });
+    const server = new Server({ name: opts.name ?? "apicity", version: opts.version ?? "0.1.0" }, { capabilities: { tools: {} } });
+    const byName = new Map(endpoints.map((e) => [e.toolName, e]));
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: endpoints.map((ep) => ({
+            name: ep.toolName,
+            description: describe(ep, opts.outputDir),
+            inputSchema: buildInputSchema(ep),
+        })),
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (req) => {
+        const ep = byName.get(req.params.name);
+        if (!ep) {
+            return errorResult(`Unknown tool: ${req.params.name}`);
+        }
+        try {
+            const result = await invoke(ep, req.params.arguments ?? {});
+            return await formatResult(ep, result, opts.outputDir);
+        }
+        catch (err) {
+            return errorResult(`${ep.toolName} failed: ${err.message ?? String(err)}`);
+        }
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(`[apicity-mcp] ready — ${endpoints.length} tools registered` +
+        (opts.outputDir ? ` (output dir: ${opts.outputDir})` : ""));
+}
+function describe(ep, outputDir) {
+    const lines = [`${ep.method} ${ep.fullUrl}`, `Docs: ${ep.docsUrl}`];
+    if (outputDir && isMediaEndpoint(ep)) {
+        lines.push(`Returned binary or media URLs are saved to: ${outputDir}`);
+    }
+    if (ep.example) {
+        const body = JSON.stringify(ep.example.payload, null, 2);
+        const truncated = body.length > 400 ? `${body.slice(0, 400).trimEnd()}\n…` : body;
+        lines.push("", `Example (${ep.example.source}):`, truncated);
+    }
+    return lines.join("\n");
+}
+function isMediaEndpoint(ep) {
+    return /audio|image|video|speech|tts|generation|sound|upload|file/i.test(ep.dotPath);
+}
+function buildInputSchema(ep) {
+    const body = zodToJsonSchema(ep.schema);
+    // If the endpoint takes path params (e.g., {taskId}), wrap them at the top
+    // level alongside the body fields and mark them required.
+    if (ep.pathParams.length === 0) {
+        if (body.type === "object")
+            return body;
+        return { type: "object", properties: {}, additionalProperties: true };
+    }
+    const properties = {};
+    const required = [];
+    for (const p of ep.pathParams) {
+        properties[p] = { type: "string", description: `Path param: {${p}}` };
+        required.push(p);
+    }
+    if (body.type === "object" && body.properties) {
+        properties.body = body;
+    }
+    else {
+        properties.body = {
+            type: "object",
+            additionalProperties: true,
+            description: "Request body (free-form)",
+        };
+    }
+    return { type: "object", properties, required };
+}
+async function invoke(ep, args) {
+    let pathArgs = [];
+    let body = args;
+    if (ep.pathParams.length > 0) {
+        pathArgs = ep.pathParams.map((p) => args[p]);
+        body = args.body ?? undefined;
+    }
+    if (body === undefined ||
+        (isPlainObject(body) && Object.keys(body).length === 0)) {
+        const result = await ep.fn(...pathArgs);
+        return await maybeBuffer(result);
+    }
+    const result = await ep.fn(...pathArgs, body);
+    return await maybeBuffer(result);
+}
+function isPlainObject(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+async function maybeBuffer(value) {
+    if (value !== null &&
+        typeof value === "object" &&
+        Symbol.asyncIterator in value) {
+        const buffered = [];
+        for await (const chunk of value)
+            buffered.push(chunk);
+        return buffered;
+    }
+    return value;
+}
+async function formatResult(ep, result, outputDir) {
+    if (isBinary(result)) {
+        if (!outputDir) {
+            const bytes = result.byteLength;
+            return text(`Endpoint returned ${bytes} binary bytes. Pass --output-dir to persist.`);
+        }
+        const ts = new Date().toISOString().replace(/[:.]/g, "-");
+        const baseName = `${ep.provider}__${ep.dotPath}__${ts}.${guessExtension(ep.dotPath)}`;
+        const out = await writeBinary(result, baseName, outputDir);
+        return text(JSON.stringify(out, null, 2));
+    }
+    let payload = result;
+    if (outputDir && payload && typeof payload === "object") {
+        payload = await downloadUrlsInResult(payload, outputDir, `${ep.provider}__${ep.dotPath}`);
+    }
+    return text(safeStringify(payload));
+}
+function text(s) {
+    return { content: [{ type: "text", text: s }] };
+}
+function errorResult(message) {
+    return { isError: true, content: [{ type: "text", text: message }] };
+}
+function safeStringify(value) {
+    try {
+        return JSON.stringify(value, null, 2);
+    }
+    catch {
+        return String(value);
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/src/server.js.map

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

package/package.json

@@ -0,0 +1,124 @@
+{
+  "name": "@apicity/mcp-server",
+  "version": "0.1.0-alpha.0",
+  "description": "Optional MCP (Model Context Protocol) server that exposes every @apicity provider endpoint as a tool.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/justintanner/apicity.git",
+    "directory": "mcp-server"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "bin": {
+    "apicity-mcp": "dist/src/bin.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/src/index.js",
+      "types": "./dist/src/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "keywords": [
+    "ai",
+    "mcp",
+    "model-context-protocol",
+    "apicity",
+    "openai",
+    "anthropic",
+    "xai",
+    "fal",
+    "kie",
+    "fireworks"
+  ],
+  "author": "Justin Tanner",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0"
+  },
+  "peerDependencies": {
+    "@apicity/anthropic": "0.1.0-alpha.0",
+    "@apicity/alibaba": "0.1.0-alpha.0",
+    "@apicity/fal": "0.1.0-alpha.0",
+    "@apicity/elevenlabs": "0.1.0-alpha.0",
+    "@apicity/fireworks": "0.1.0-alpha.0",
+    "@apicity/free-media-upload": "0.1.0-alpha.0",
+    "@apicity/meta": "0.1.0-alpha.0",
+    "@apicity/kie": "0.1.0-alpha.0",
+    "@apicity/kimicoding": "0.1.0-alpha.0",
+    "@apicity/openai": "0.1.0-alpha.0",
+    "@apicity/x": "0.1.0-alpha.0",
+    "@apicity/xai": "0.1.0-alpha.0"
+  },
+  "peerDependenciesMeta": {
+    "@apicity/alibaba": {
+      "optional": true
+    },
+    "@apicity/anthropic": {
+      "optional": true
+    },
+    "@apicity/elevenlabs": {
+      "optional": true
+    },
+    "@apicity/fal": {
+      "optional": true
+    },
+    "@apicity/fireworks": {
+      "optional": true
+    },
+    "@apicity/free-media-upload": {
+      "optional": true
+    },
+    "@apicity/meta": {
+      "optional": true
+    },
+    "@apicity/kie": {
+      "optional": true
+    },
+    "@apicity/kimicoding": {
+      "optional": true
+    },
+    "@apicity/openai": {
+      "optional": true
+    },
+    "@apicity/x": {
+      "optional": true
+    },
+    "@apicity/xai": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@apicity/alibaba": "0.1.0-alpha.0",
+    "@apicity/anthropic": "0.1.0-alpha.0",
+    "@apicity/fal": "0.1.0-alpha.0",
+    "@apicity/fireworks": "0.1.0-alpha.0",
+    "@apicity/elevenlabs": "0.1.0-alpha.0",
+    "@apicity/meta": "0.1.0-alpha.0",
+    "@apicity/free-media-upload": "0.1.0-alpha.0",
+    "@apicity/kie": "0.1.0-alpha.0",
+    "@apicity/openai": "0.1.0-alpha.0",
+    "@apicity/x": "0.1.0-alpha.0",
+    "@apicity/kimicoding": "0.1.0-alpha.0",
+    "@apicity/xai": "0.1.0-alpha.0"
+  },
+  "homepage": "https://github.com/justintanner/apicity#readme",
+  "bugs": {
+    "url": "https://github.com/justintanner/apicity/issues"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node scripts/dist.mjs"
+  }
+}