mudbase-mcp-server 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mudbase Team
+
+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,118 @@
+# mudbase-mcp-server
+
+An MCP (Model Context Protocol) server that exposes Mudbase's database, storage, and search
+capabilities as tools for Claude Code, Claude Desktop, and any other MCP client.
+
+Every request is authenticated with a Mudbase API key, so this connects your assistant directly
+to real data in your own Mudbase project: list and query collections, read and write documents,
+search across a project, and manage files in storage.
+
+## Requirements
+
+- A Mudbase account and project. If you don't have one yet, create one at
+  [cloud.mudbase.dev](https://cloud.mudbase.dev).
+- An API key for that project, generated from your project's API Keys settings.
+- Node.js 18 or newer (only needed to run `npx`; most MCP clients already bundle Node).
+
+## Install
+
+No install step is required. Point your MCP client at `npx mudbase-mcp-server` and it will
+download and run the latest version on demand.
+
+### Claude Code
+
+Add this to your Claude Code MCP configuration:
+
+```json
+{
+  "mcpServers": {
+    "mudbase": {
+      "command": "npx",
+      "args": ["mudbase-mcp-server"],
+      "env": { "MUDBASE_API_KEY": "ak_..." }
+    }
+  }
+}
+```
+
+Replace `ak_...` with a real API key from your Mudbase project settings. Restart Claude Code (or
+reload MCP servers) and the `mudbase_*` tools become available.
+
+### Other MCP clients
+
+Any client that can launch an MCP server over stdio works the same way: run `npx
+mudbase-mcp-server` as the command, with `MUDBASE_API_KEY` set in its environment. Consult your
+client's own docs for where to put the `command` / `args` / `env` fields; the shape above is the
+common one.
+
+## Configuration
+
+| Environment variable | Required | Description |
+| --- | --- | --- |
+| `MUDBASE_API_KEY` | Yes | Your Mudbase project API key. The server refuses to start without it and prints a clear error explaining how to set it. |
+| `MUDBASE_BASE_URL` | No | Override the API base URL (defaults to `https://cloud.mudbase.dev`). Only needed for a self-hosted or non-default deployment. |
+
+The API key is read from the environment only. It is never logged, never written to disk, and
+never hardcoded anywhere in this package.
+
+## Available tools
+
+**Collections** (read-only schema access)
+
+- `mudbase_list_collections`: list every collection in a project, with each field's declared type.
+- `mudbase_get_collection`: get one collection's full field schema and permission settings.
+
+**Documents** (collection data)
+
+- `mudbase_list_documents`: list documents in a collection, with pagination, sorting, and a JSON filter.
+- `mudbase_get_document`: fetch a single document by ID.
+- `mudbase_create_document`: create a new document.
+- `mudbase_update_document`: partially update an existing document.
+- `mudbase_delete_document`: permanently delete a document.
+
+**Search**
+
+- `mudbase_search_documents`: full-text search across a project, optionally scoped to specific collections or fields.
+
+**Storage**
+
+- `mudbase_list_buckets`: list the storage buckets in a project.
+- `mudbase_list_files`: list files in a bucket, with search and MIME-type filters.
+- `mudbase_get_file`: get metadata for a single stored file.
+- `mudbase_upload_file`: upload a file from base64-encoded content.
+- `mudbase_delete_file`: permanently delete a file.
+- `mudbase_get_file_download_url`: generate a time-limited signed download URL for a file.
+
+Every tool is a thin, typed wrapper over one real Mudbase API endpoint; none of them add new
+business logic beyond request shaping and error normalization. `mudbase_delete_document` and
+`mudbase_delete_file` are marked destructive in their tool metadata so a client can prompt for
+confirmation before calling them.
+
+## How errors are reported
+
+A failed API call (invalid API key, missing project, validation error, rate limit, and so on)
+never crashes the server or throws an unhandled exception. It comes back to the MCP client as a
+normal tool result with `isError: true` and a JSON body describing what went wrong, for example:
+
+```json
+{
+  "error": "Mudbase rejected this API key. Check that MUDBASE_API_KEY is a valid, active key with access to this project.",
+  "status": 401,
+  "code": "unauthorized"
+}
+```
+
+## Development
+
+```bash
+npm install
+npm run build       # compile TypeScript to dist/
+npm run dev          # run the server directly from source with tsx
+npm test              # run the unit test suite
+npm run typecheck      # tsc --noEmit
+npm run lint             # eslint
+```
+
+## License
+
+MIT. Built by the Mudbase Team.

package/dist/client.d.ts

@@ -0,0 +1,117 @@
+/** Default Mudbase API base URL. Override with MUDBASE_BASE_URL for self-hosted or staging use. */
+export declare const DEFAULT_BASE_URL = "https://cloud.mudbase.dev";
+/** Normalized error thrown for any failed Mudbase API call. */
+export declare class MudbaseApiError extends Error {
+    readonly status?: number;
+    readonly code?: string;
+    readonly details?: unknown;
+    constructor(message: string, options?: {
+        status?: number;
+        code?: string;
+        details?: unknown;
+    });
+}
+export interface MudbaseClientOptions {
+    /** A Mudbase project or organization API key (X-API-Key). */
+    apiKey: string;
+    /** Override the API base URL. Defaults to https://cloud.mudbase.dev. */
+    baseUrl?: string;
+}
+interface UploadFileParams {
+    projectId: string;
+    bucketId: string;
+    filename: string;
+    contentBase64: string;
+    mimeType?: string;
+    isPublic?: boolean;
+}
+/**
+ * Thin, typed wrapper over the public Mudbase REST API. Every method maps to exactly one
+ * documented endpoint; no client-side business logic beyond request shaping and error
+ * normalization. Authenticates every request with the caller's API key, matching the same
+ * X-API-Key header the Mudbase SDKs and REST docs use for programmatic access.
+ */
+export declare class MudbaseClient {
+    private readonly http;
+    constructor(options: MudbaseClientOptions);
+    private request;
+    listCollections(params: {
+        projectId: string;
+    }): Promise<unknown>;
+    getCollection(params: {
+        projectId: string;
+        collectionId: string;
+    }): Promise<unknown>;
+    listDocuments(params: {
+        projectId: string;
+        collectionId: string;
+        page?: number;
+        limit?: number;
+        sort?: string;
+        filter?: string;
+    }): Promise<unknown>;
+    getDocument(params: {
+        projectId: string;
+        collectionId: string;
+        documentId: string;
+    }): Promise<unknown>;
+    createDocument(params: {
+        projectId: string;
+        collectionId: string;
+        data: Record<string, unknown>;
+    }): Promise<unknown>;
+    updateDocument(params: {
+        projectId: string;
+        collectionId: string;
+        documentId: string;
+        data: Record<string, unknown>;
+    }): Promise<unknown>;
+    deleteDocument(params: {
+        projectId: string;
+        collectionId: string;
+        documentId: string;
+    }): Promise<unknown>;
+    searchDocuments(params: {
+        projectId: string;
+        query: string;
+        collections?: string;
+        fields?: string;
+        page?: number;
+        limit?: number;
+    }): Promise<unknown>;
+    listBuckets(params: {
+        projectId: string;
+        search?: string;
+        page?: number;
+        limit?: number;
+    }): Promise<unknown>;
+    listFiles(params: {
+        projectId: string;
+        bucketId: string;
+        search?: string;
+        type?: string;
+        page?: number;
+        limit?: number;
+    }): Promise<unknown>;
+    getFile(params: {
+        projectId: string;
+        bucketId: string;
+        fileId: string;
+    }): Promise<unknown>;
+    deleteFile(params: {
+        projectId: string;
+        bucketId: string;
+        fileId: string;
+    }): Promise<unknown>;
+    getFileDownloadUrl(params: {
+        projectId: string;
+        bucketId: string;
+        fileId: string;
+        expiresIn?: number;
+    }): Promise<unknown>;
+    uploadFile(params: UploadFileParams): Promise<unknown>;
+}
+/** Turn any thrown error from an HTTP call into a normalized, human-readable MudbaseApiError. */
+export declare function toMudbaseApiError(error: unknown): MudbaseApiError;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,213 @@
+import axios, { isAxiosError } from "axios";
+import FormData from "form-data";
+/** Default Mudbase API base URL. Override with MUDBASE_BASE_URL for self-hosted or staging use. */
+export const DEFAULT_BASE_URL = "https://cloud.mudbase.dev";
+/** Normalized error thrown for any failed Mudbase API call. */
+export class MudbaseApiError extends Error {
+    status;
+    code;
+    details;
+    constructor(message, options = {}) {
+        super(message);
+        this.name = "MudbaseApiError";
+        this.status = options.status;
+        this.code = options.code;
+        this.details = options.details;
+    }
+}
+/**
+ * Thin, typed wrapper over the public Mudbase REST API. Every method maps to exactly one
+ * documented endpoint; no client-side business logic beyond request shaping and error
+ * normalization. Authenticates every request with the caller's API key, matching the same
+ * X-API-Key header the Mudbase SDKs and REST docs use for programmatic access.
+ */
+export class MudbaseClient {
+    http;
+    constructor(options) {
+        if (!options.apiKey || options.apiKey.trim().length === 0) {
+            throw new Error("A Mudbase API key is required. Set the MUDBASE_API_KEY environment variable to a key " +
+                "from your Mudbase project settings.");
+        }
+        const baseURL = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+        this.http = axios.create({
+            baseURL,
+            timeout: 30_000,
+            headers: {
+                "X-API-Key": options.apiKey,
+                Accept: "application/json",
+            },
+        });
+    }
+    async request(config) {
+        try {
+            const response = await this.http.request(config);
+            return response.data;
+        }
+        catch (error) {
+            throw toMudbaseApiError(error);
+        }
+    }
+    // ---- Collections (read-only schema access) ----
+    listCollections(params) {
+        return this.request({
+            method: "GET",
+            url: `/api/schemas/projects/${encodeURIComponent(params.projectId)}/collections`,
+        });
+    }
+    getCollection(params) {
+        return this.request({
+            method: "GET",
+            url: `/api/schemas/projects/${encodeURIComponent(params.projectId)}/collections/${encodeURIComponent(params.collectionId)}`,
+        });
+    }
+    // ---- Documents (collection data CRUD) ----
+    listDocuments(params) {
+        return this.request({
+            method: "GET",
+            url: `/api/data/projects/${encodeURIComponent(params.projectId)}/collections/${encodeURIComponent(params.collectionId)}/data`,
+            params: {
+                page: params.page,
+                limit: params.limit,
+                sort: params.sort,
+                filter: params.filter,
+            },
+        });
+    }
+    getDocument(params) {
+        return this.request({
+            method: "GET",
+            url: `/api/data/projects/${encodeURIComponent(params.projectId)}/collections/${encodeURIComponent(params.collectionId)}/data/${encodeURIComponent(params.documentId)}`,
+        });
+    }
+    createDocument(params) {
+        return this.request({
+            method: "POST",
+            url: `/api/data/projects/${encodeURIComponent(params.projectId)}/collections/${encodeURIComponent(params.collectionId)}/data`,
+            data: params.data,
+        });
+    }
+    updateDocument(params) {
+        return this.request({
+            method: "PATCH",
+            url: `/api/data/projects/${encodeURIComponent(params.projectId)}/collections/${encodeURIComponent(params.collectionId)}/data/${encodeURIComponent(params.documentId)}`,
+            data: params.data,
+        });
+    }
+    deleteDocument(params) {
+        return this.request({
+            method: "DELETE",
+            url: `/api/data/projects/${encodeURIComponent(params.projectId)}/collections/${encodeURIComponent(params.collectionId)}/data/${encodeURIComponent(params.documentId)}`,
+        });
+    }
+    // ---- Search ----
+    searchDocuments(params) {
+        return this.request({
+            method: "GET",
+            url: `/api/search/projects/${encodeURIComponent(params.projectId)}/search`,
+            params: {
+                q: params.query,
+                collections: params.collections,
+                fields: params.fields,
+                page: params.page,
+                limit: params.limit,
+            },
+        });
+    }
+    // ---- Storage (buckets and files) ----
+    listBuckets(params) {
+        return this.request({
+            method: "GET",
+            url: `/api/bucket/projects/${encodeURIComponent(params.projectId)}/buckets`,
+            params: { search: params.search, page: params.page, limit: params.limit },
+        });
+    }
+    listFiles(params) {
+        return this.request({
+            method: "GET",
+            url: `/api/bucket/projects/${encodeURIComponent(params.projectId)}/buckets/${encodeURIComponent(params.bucketId)}/files`,
+            params: { search: params.search, type: params.type, page: params.page, limit: params.limit },
+        });
+    }
+    getFile(params) {
+        return this.request({
+            method: "GET",
+            url: `/api/bucket/projects/${encodeURIComponent(params.projectId)}/buckets/${encodeURIComponent(params.bucketId)}/files/${encodeURIComponent(params.fileId)}`,
+        });
+    }
+    deleteFile(params) {
+        return this.request({
+            method: "DELETE",
+            url: `/api/bucket/projects/${encodeURIComponent(params.projectId)}/buckets/${encodeURIComponent(params.bucketId)}/files/${encodeURIComponent(params.fileId)}`,
+        });
+    }
+    getFileDownloadUrl(params) {
+        return this.request({
+            method: "POST",
+            url: `/api/bucket/projects/${encodeURIComponent(params.projectId)}/buckets/${encodeURIComponent(params.bucketId)}/files/${encodeURIComponent(params.fileId)}/signed-url`,
+            data: { expiresIn: params.expiresIn },
+        });
+    }
+    async uploadFile(params) {
+        const buffer = Buffer.from(params.contentBase64, "base64");
+        if (buffer.length === 0) {
+            throw new MudbaseApiError("contentBase64 decoded to an empty file. Nothing was uploaded.", {
+                code: "empty_file",
+            });
+        }
+        const form = new FormData();
+        form.append("files", buffer, {
+            filename: params.filename,
+            contentType: params.mimeType || "application/octet-stream",
+        });
+        if (params.isPublic !== undefined) {
+            form.append("isPublic", String(params.isPublic));
+        }
+        return this.request({
+            method: "POST",
+            url: `/api/bucket/projects/${encodeURIComponent(params.projectId)}/buckets/${encodeURIComponent(params.bucketId)}/files`,
+            data: form,
+            headers: form.getHeaders(),
+            maxBodyLength: Infinity,
+            maxContentLength: Infinity,
+        });
+    }
+}
+/** Turn any thrown error from an HTTP call into a normalized, human-readable MudbaseApiError. */
+export function toMudbaseApiError(error) {
+    if (error instanceof MudbaseApiError) {
+        return error;
+    }
+    if (isAxiosError(error)) {
+        const status = error.response?.status;
+        const body = error.response?.data;
+        const bodyMessage = typeof body?.error === "string" ? body.error : undefined;
+        const code = typeof body?.code === "string" ? body.code : undefined;
+        if (error.code === "ECONNABORTED") {
+            return new MudbaseApiError("The request to Mudbase timed out.", { code: "timeout" });
+        }
+        if (!error.response) {
+            return new MudbaseApiError(`Could not reach the Mudbase API (${error.message}). Check your network connection and the base URL.`, { code: "network_error" });
+        }
+        if (status === 401 || status === 403) {
+            return new MudbaseApiError(bodyMessage ??
+                "Mudbase rejected this API key. Check that MUDBASE_API_KEY is a valid, active key with access to this project.", { status, code: code ?? "unauthorized", details: body });
+        }
+        if (status === 429) {
+            return new MudbaseApiError(bodyMessage ?? "Rate limited by Mudbase. Slow down and retry.", {
+                status,
+                code: code ?? "rate_limited",
+                details: body,
+            });
+        }
+        return new MudbaseApiError(bodyMessage ?? `Mudbase API request failed with status ${status}.`, {
+            status,
+            code,
+            details: body,
+        });
+    }
+    if (error instanceof Error) {
+        return new MudbaseApiError(error.message);
+    }
+    return new MudbaseApiError("An unknown error occurred while calling the Mudbase API.");
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

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,24 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+import { DEFAULT_BASE_URL } from "./client.js";
+async function main() {
+    const apiKey = process.env.MUDBASE_API_KEY;
+    if (!apiKey || apiKey.trim().length === 0) {
+        console.error("[mudbase-mcp-server] MUDBASE_API_KEY is not set. Add it to your MCP client's env config, e.g.:\n" +
+            '  { "mcpServers": { "mudbase": { "command": "npx", "args": ["mudbase-mcp-server"], ' +
+            '"env": { "MUDBASE_API_KEY": "ak_..." } } } }\n' +
+            "Get an API key from your Mudbase project settings at https://cloud.mudbase.dev.");
+        process.exit(1);
+    }
+    const baseUrl = process.env.MUDBASE_BASE_URL || DEFAULT_BASE_URL;
+    const server = createServer({ apiKey, baseUrl });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(`[mudbase-mcp-server] running on stdio, base URL ${baseUrl}`);
+}
+main().catch((error) => {
+    console.error("[mudbase-mcp-server] fatal error:", error);
+    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,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC3C,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1C,OAAO,CAAC,KAAK,CACX,kGAAkG;YAChG,qFAAqF;YACrF,gDAAgD;YAChD,iFAAiF,CACpF,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,gBAAgB,CAAC;IAEjE,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,CAAC,KAAK,CAAC,mDAAmD,OAAO,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,10 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const SERVER_NAME = "mudbase-mcp-server";
+export declare const SERVER_VERSION = "0.1.0";
+export interface CreateServerOptions {
+    apiKey: string;
+    baseUrl?: string;
+}
+/** Build a fully configured, not-yet-connected Mudbase MCP server. */
+export declare function createServer(options: CreateServerOptions): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,eAAO,MAAM,WAAW,uBAAuB,CAAC;AAChD,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,SAAS,CAWpE"}

package/dist/server.js

@@ -0,0 +1,16 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { MudbaseClient, DEFAULT_BASE_URL } from "./client.js";
+import { registerAllTools } from "./tools/index.js";
+export const SERVER_NAME = "mudbase-mcp-server";
+export const SERVER_VERSION = "0.1.0";
+/** Build a fully configured, not-yet-connected Mudbase MCP server. */
+export function createServer(options) {
+    const client = new MudbaseClient({ apiKey: options.apiKey, baseUrl: options.baseUrl ?? DEFAULT_BASE_URL });
+    const server = new McpServer({
+        name: SERVER_NAME,
+        version: SERVER_VERSION,
+    });
+    registerAllTools(server, client);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,CAAC,MAAM,WAAW,GAAG,oBAAoB,CAAC;AAChD,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAOtC,sEAAsE;AACtE,MAAM,UAAU,YAAY,CAAC,OAA4B;IACvD,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,gBAAgB,EAAE,CAAC,CAAC;IAE3G,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,cAAc;KACxB,CAAC,CAAC;IAEH,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/toolResult.d.ts

@@ -0,0 +1,8 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+/** Wrap a successful tool result as pretty-printed JSON text content. */
+export declare function toolSuccess(data: unknown): CallToolResult;
+/** Wrap a failed tool call as an MCP error result, never as a thrown exception. */
+export declare function toolFailure(error: unknown): CallToolResult;
+/** Run a tool handler, converting any thrown error into a well-formed MCP error result. */
+export declare function runTool(fn: () => Promise<unknown>): Promise<CallToolResult>;
+//# sourceMappingURL=toolResult.d.ts.map

package/dist/toolResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolResult.d.ts","sourceRoot":"","sources":["../src/toolResult.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAGzE,yEAAyE;AACzE,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CASzD;AAED,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAc1D;AAED,2FAA2F;AAC3F,wBAAsB,OAAO,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAOjF"}

package/dist/toolResult.js

@@ -0,0 +1,41 @@
+import { MudbaseApiError, toMudbaseApiError } from "./client.js";
+/** Wrap a successful tool result as pretty-printed JSON text content. */
+export function toolSuccess(data) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(data, null, 2),
+            },
+        ],
+    };
+}
+/** Wrap a failed tool call as an MCP error result, never as a thrown exception. */
+export function toolFailure(error) {
+    const apiError = error instanceof MudbaseApiError ? error : toMudbaseApiError(error);
+    const payload = { error: apiError.message };
+    if (apiError.status !== undefined)
+        payload.status = apiError.status;
+    if (apiError.code !== undefined)
+        payload.code = apiError.code;
+    return {
+        isError: true,
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(payload, null, 2),
+            },
+        ],
+    };
+}
+/** Run a tool handler, converting any thrown error into a well-formed MCP error result. */
+export async function runTool(fn) {
+    try {
+        const result = await fn();
+        return toolSuccess(result);
+    }
+    catch (error) {
+        return toolFailure(error);
+    }
+}
+//# sourceMappingURL=toolResult.js.map

package/dist/toolResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolResult.js","sourceRoot":"","sources":["../src/toolResult.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEjE,yEAAyE;AACzE,MAAM,UAAU,WAAW,CAAC,IAAa;IACvC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;aACpC;SACF;KACF,CAAC;AACJ,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,MAAM,QAAQ,GAAG,KAAK,YAAY,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACrF,MAAM,OAAO,GAA4B,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;IACrE,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;IACpE,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC9D,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;aACvC;SACF;KACF,CAAC;AACJ,CAAC;AAED,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,EAA0B;IACtD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;QAC1B,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC"}

package/dist/tools/collections.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { MudbaseClient } from "../client.js";
+export declare function registerCollectionTools(server: McpServer, client: MudbaseClient): void;
+//# sourceMappingURL=collections.d.ts.map

package/dist/tools/collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../../src/tools/collections.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAMlD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAuBtF"}

package/dist/tools/collections.js

@@ -0,0 +1,18 @@
+import { z } from "zod";
+import { runTool } from "../toolResult.js";
+const projectId = z.string().min(1).describe("The Mudbase project ID.");
+const collectionId = z.string().min(1).describe("The collection ID within the project.");
+export function registerCollectionTools(server, client) {
+    server.registerTool("mudbase_list_collections", {
+        title: "List Mudbase collections",
+        description: "List every collection (schema) defined in a Mudbase project, including each field's name and type. " +
+            "Call this before reading or writing documents to see what collections and fields actually exist.",
+        inputSchema: { projectId },
+    }, async (args) => runTool(() => client.listCollections({ projectId: args.projectId })));
+    server.registerTool("mudbase_get_collection", {
+        title: "Get a Mudbase collection's schema",
+        description: "Get the full field schema and permission settings for one collection in a Mudbase project.",
+        inputSchema: { projectId, collectionId },
+    }, async (args) => runTool(() => client.getCollection({ projectId: args.projectId, collectionId: args.collectionId })));
+}
+//# sourceMappingURL=collections.js.map

package/dist/tools/collections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.js","sourceRoot":"","sources":["../../src/tools/collections.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAC;AACxE,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uCAAuC,CAAC,CAAC;AAEzF,MAAM,UAAU,uBAAuB,CAAC,MAAiB,EAAE,MAAqB;IAC9E,MAAM,CAAC,YAAY,CACjB,0BAA0B,EAC1B;QACE,KAAK,EAAE,0BAA0B;QACjC,WAAW,EACT,qGAAqG;YACrG,kGAAkG;QACpG,WAAW,EAAE,EAAE,SAAS,EAAE;KAC3B,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CACrF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,KAAK,EAAE,mCAAmC;QAC1C,WAAW,EAAE,4FAA4F;QACzG,WAAW,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE;KACzC,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CACtG,CAAC;AACJ,CAAC"}

package/dist/tools/documents.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { MudbaseClient } from "../client.js";
+export declare function registerDocumentTools(server: McpServer, client: MudbaseClient): void;
+//# sourceMappingURL=documents.d.ts.map

package/dist/tools/documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/tools/documents.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAQlD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAuGpF"}

package/dist/tools/documents.js

@@ -0,0 +1,69 @@
+import { z } from "zod";
+import { runTool } from "../toolResult.js";
+const projectId = z.string().min(1).describe("The Mudbase project ID.");
+const collectionId = z.string().min(1).describe("The collection ID to operate on.");
+const documentId = z.string().min(1).describe("The document ID within the collection.");
+const documentData = z.record(z.string(), z.unknown()).describe("The document fields as a plain JSON object.");
+export function registerDocumentTools(server, client) {
+    server.registerTool("mudbase_list_documents", {
+        title: "List documents in a Mudbase collection",
+        description: "List documents in a Mudbase collection, with pagination, sorting, and an optional filter. " +
+            "'filter' is a JSON-encoded object using Mudbase's structured query operators, e.g. " +
+            '\'{"status":"active"}\' or \'{"age":{"$gte":18}}\'.',
+        inputSchema: {
+            projectId,
+            collectionId,
+            page: z.number().int().min(1).optional().describe("Page number, starting at 1. Defaults to 1."),
+            limit: z.number().int().min(1).max(100).optional().describe("Documents per page, max 100. Defaults to 20."),
+            sort: z
+                .string()
+                .optional()
+                .describe("Sort field(s), e.g. '-createdAt' for newest first, or 'name' for ascending."),
+            filter: z.string().optional().describe("A JSON-encoded filter object using Mudbase's structured query operators."),
+        },
+    }, async (args) => runTool(() => client.listDocuments({
+        projectId: args.projectId,
+        collectionId: args.collectionId,
+        page: args.page,
+        limit: args.limit,
+        sort: args.sort,
+        filter: args.filter,
+    })));
+    server.registerTool("mudbase_get_document", {
+        title: "Get a single Mudbase document",
+        description: "Fetch a single document by ID from a Mudbase collection.",
+        inputSchema: { projectId, collectionId, documentId },
+    }, async (args) => runTool(() => client.getDocument({
+        projectId: args.projectId,
+        collectionId: args.collectionId,
+        documentId: args.documentId,
+    })));
+    server.registerTool("mudbase_create_document", {
+        title: "Create a Mudbase document",
+        description: "Create a new document in a Mudbase collection. 'data' must match the collection's declared field " +
+            "schema (see mudbase_get_collection). Fires the collection's configured webhooks and triggers.",
+        inputSchema: { projectId, collectionId, data: documentData },
+    }, async (args) => runTool(() => client.createDocument({ projectId: args.projectId, collectionId: args.collectionId, data: args.data })));
+    server.registerTool("mudbase_update_document", {
+        title: "Update a Mudbase document",
+        description: "Partially update an existing document. Only the fields included in 'data' are changed; omitted " +
+            "fields are left as-is.",
+        inputSchema: { projectId, collectionId, documentId, data: documentData },
+    }, async (args) => runTool(() => client.updateDocument({
+        projectId: args.projectId,
+        collectionId: args.collectionId,
+        documentId: args.documentId,
+        data: args.data,
+    })));
+    server.registerTool("mudbase_delete_document", {
+        title: "Delete a Mudbase document",
+        description: "Permanently delete a single document from a Mudbase collection. This cannot be undone.",
+        inputSchema: { projectId, collectionId, documentId },
+        annotations: { destructiveHint: true },
+    }, async (args) => runTool(() => client.deleteDocument({
+        projectId: args.projectId,
+        collectionId: args.collectionId,
+        documentId: args.documentId,
+    })));
+}
+//# sourceMappingURL=documents.js.map

package/dist/tools/documents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.js","sourceRoot":"","sources":["../../src/tools/documents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAC;AACxE,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,kCAAkC,CAAC,CAAC;AACpF,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,wCAAwC,CAAC,CAAC;AACxF,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,6CAA6C,CAAC,CAAC;AAE/G,MAAM,UAAU,qBAAqB,CAAC,MAAiB,EAAE,MAAqB;IAC5E,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,KAAK,EAAE,wCAAwC;QAC/C,WAAW,EACT,4FAA4F;YAC5F,qFAAqF;YACrF,qDAAqD;QACvD,WAAW,EAAE;YACX,SAAS;YACT,YAAY;YACZ,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;YAC/F,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;YAC3G,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,6EAA6E,CAAC;YAC1F,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0EAA0E,CAAC;SACnH;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,OAAO,CAAC,GAAG,EAAE,CACX,MAAM,CAAC,aAAa,CAAC;QACnB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC,CACH,CACJ,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,KAAK,EAAE,+BAA+B;QACtC,WAAW,EAAE,0DAA0D;QACvE,WAAW,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE;KACrD,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,OAAO,CAAC,GAAG,EAAE,CACX,MAAM,CAAC,WAAW,CAAC;QACjB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC,CACH,CACJ,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,KAAK,EAAE,2BAA2B;QAClC,WAAW,EACT,mGAAmG;YACnG,+FAA+F;QACjG,WAAW,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE;KAC7D,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,OAAO,CAAC,GAAG,EAAE,CACX,MAAM,CAAC,cAAc,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CACvG,CACJ,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,KAAK,EAAE,2BAA2B;QAClC,WAAW,EACT,iGAAiG;YACjG,wBAAwB;QAC1B,WAAW,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE;KACzE,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,OAAO,CAAC,GAAG,EAAE,CACX,MAAM,CAAC,cAAc,CAAC;QACpB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;KAChB,CAAC,CACH,CACJ,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,KAAK,EAAE,2BAA2B;QAClC,WAAW,EAAE,wFAAwF;QACrG,WAAW,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE;QACpD,WAAW,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;KACvC,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,OAAO,CAAC,GAAG,EAAE,CACX,MAAM,CAAC,cAAc,CAAC;QACpB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC,CACH,CACJ,CAAC;AACJ,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { MudbaseClient } from "../client.js";
+/** Register every Mudbase tool onto the given MCP server, bound to one authenticated client. */
+export declare function registerAllTools(server: McpServer, client: MudbaseClient): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAMlD,gGAAgG;AAChG,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAK/E"}

package/dist/tools/index.js

@@ -0,0 +1,12 @@
+import { registerCollectionTools } from "./collections.js";
+import { registerDocumentTools } from "./documents.js";
+import { registerSearchTools } from "./search.js";
+import { registerStorageTools } from "./storage.js";
+/** Register every Mudbase tool onto the given MCP server, bound to one authenticated client. */
+export function registerAllTools(server, client) {
+    registerCollectionTools(server, client);
+    registerDocumentTools(server, client);
+    registerSearchTools(server, client);
+    registerStorageTools(server, client);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,gGAAgG;AAChG,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,MAAqB;IACvE,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACvC,CAAC"}

package/dist/tools/search.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { MudbaseClient } from "../client.js";
+export declare function registerSearchTools(server: McpServer, client: MudbaseClient): void;
+//# sourceMappingURL=search.d.ts.map

package/dist/tools/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAgClF"}

package/dist/tools/search.js

@@ -0,0 +1,28 @@
+import { z } from "zod";
+import { runTool } from "../toolResult.js";
+export function registerSearchTools(server, client) {
+    server.registerTool("mudbase_search_documents", {
+        title: "Search across a Mudbase project",
+        description: "Full-text search across a Mudbase project's collections. Optionally scope to specific collections " +
+            "or fields.",
+        inputSchema: {
+            projectId: z.string().min(1).describe("The Mudbase project ID."),
+            query: z.string().min(1).max(100).describe("The search query, 1 to 100 characters."),
+            collections: z
+                .string()
+                .optional()
+                .describe("Comma-separated collection slugs to restrict the search to. Omit to search all."),
+            fields: z.string().optional().describe("Comma-separated field names to restrict matching to."),
+            page: z.number().int().min(1).optional().describe("Page number, starting at 1. Defaults to 1."),
+            limit: z.number().int().min(1).max(100).optional().describe("Results per page, max 100. Defaults to 20."),
+        },
+    }, async (args) => runTool(() => client.searchDocuments({
+        projectId: args.projectId,
+        query: args.query,
+        collections: args.collections,
+        fields: args.fields,
+        page: args.page,
+        limit: args.limit,
+    })));
+}
+//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,MAAqB;IAC1E,MAAM,CAAC,YAAY,CACjB,0BAA0B,EAC1B;QACE,KAAK,EAAE,iCAAiC;QACxC,WAAW,EACT,oGAAoG;YACpG,YAAY;QACd,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;YAChE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,wCAAwC,CAAC;YACpF,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,iFAAiF,CAAC;YAC9F,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC;YAC9F,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;YAC/F,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;SAC1G;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,OAAO,CAAC,GAAG,EAAE,CACX,MAAM,CAAC,eAAe,CAAC;QACrB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC,CACH,CACJ,CAAC;AACJ,CAAC"}

package/dist/tools/storage.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { MudbaseClient } from "../client.js";
+export declare function registerStorageTools(server: McpServer, client: MudbaseClient): void;
+//# sourceMappingURL=storage.d.ts.map

package/dist/tools/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/tools/storage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAOlD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAkInF"}

package/dist/tools/storage.js

@@ -0,0 +1,93 @@
+import { z } from "zod";
+import { runTool } from "../toolResult.js";
+const projectId = z.string().min(1).describe("The Mudbase project ID.");
+const bucketId = z.string().min(1).describe("The storage bucket ID within the project.");
+const fileId = z.string().min(1).describe("The file ID within the bucket.");
+export function registerStorageTools(server, client) {
+    server.registerTool("mudbase_list_buckets", {
+        title: "List Mudbase storage buckets",
+        description: "List the storage buckets configured in a Mudbase project.",
+        inputSchema: {
+            projectId,
+            search: z.string().optional().describe("Filter buckets whose name matches this text."),
+            page: z.number().int().min(1).optional().describe("Page number, starting at 1. Defaults to 1."),
+            limit: z.number().int().min(1).max(100).optional().describe("Buckets per page, max 100. Defaults to 20."),
+        },
+    }, async (args) => runTool(() => client.listBuckets({ projectId: args.projectId, search: args.search, page: args.page, limit: args.limit })));
+    server.registerTool("mudbase_list_files", {
+        title: "List files in a Mudbase bucket",
+        description: "List the files stored in one Mudbase storage bucket, with optional search and MIME type filter.",
+        inputSchema: {
+            projectId,
+            bucketId,
+            search: z.string().optional().describe("Filter files whose name matches this text."),
+            type: z.string().optional().describe("Filter by exact MIME type, e.g. 'image/png'."),
+            page: z.number().int().min(1).optional().describe("Page number, starting at 1. Defaults to 1."),
+            limit: z.number().int().min(1).max(100).optional().describe("Files per page, max 100. Defaults to 20."),
+        },
+    }, async (args) => runTool(() => client.listFiles({
+        projectId: args.projectId,
+        bucketId: args.bucketId,
+        search: args.search,
+        type: args.type,
+        page: args.page,
+        limit: args.limit,
+    })));
+    server.registerTool("mudbase_get_file", {
+        title: "Get Mudbase file metadata",
+        description: "Get metadata (name, size, MIME type, visibility, timestamps) for a single stored file.",
+        inputSchema: { projectId, bucketId, fileId },
+    }, async (args) => runTool(() => client.getFile({ projectId: args.projectId, bucketId: args.bucketId, fileId: args.fileId })));
+    server.registerTool("mudbase_upload_file", {
+        title: "Upload a file to Mudbase storage",
+        description: "Upload a file to a Mudbase storage bucket. Provide the file content as a base64-encoded string. " +
+            "Best for small to moderate files (text, small images, JSON, documents) passed inline; not intended " +
+            "for very large binaries.",
+        inputSchema: {
+            projectId,
+            bucketId,
+            filename: z.string().min(1).describe("The file name to store, including its extension."),
+            contentBase64: z.string().min(1).describe("The file's raw bytes, base64-encoded."),
+            mimeType: z.string().optional().describe("The file's MIME type, e.g. 'image/png' or 'application/pdf'."),
+            isPublic: z
+                .boolean()
+                .optional()
+                .describe("Whether the uploaded file should be publicly readable. Defaults to the bucket's setting."),
+        },
+    }, async (args) => runTool(() => client.uploadFile({
+        projectId: args.projectId,
+        bucketId: args.bucketId,
+        filename: args.filename,
+        contentBase64: args.contentBase64,
+        mimeType: args.mimeType,
+        isPublic: args.isPublic,
+    })));
+    server.registerTool("mudbase_delete_file", {
+        title: "Delete a Mudbase file",
+        description: "Permanently delete a file from a Mudbase storage bucket. This cannot be undone.",
+        inputSchema: { projectId, bucketId, fileId },
+        annotations: { destructiveHint: true },
+    }, async (args) => runTool(() => client.deleteFile({ projectId: args.projectId, bucketId: args.bucketId, fileId: args.fileId })));
+    server.registerTool("mudbase_get_file_download_url", {
+        title: "Get a signed download URL for a Mudbase file",
+        description: "Generate a time-limited signed URL to download a private or public file from Mudbase storage.",
+        inputSchema: {
+            projectId,
+            bucketId,
+            fileId,
+            expiresIn: z
+                .number()
+                .int()
+                .min(60)
+                .max(604_800)
+                .optional()
+                .describe("How long the URL stays valid, in seconds. Defaults to 3600 (1 hour)."),
+        },
+    }, async (args) => runTool(() => client.getFileDownloadUrl({
+        projectId: args.projectId,
+        bucketId: args.bucketId,
+        fileId: args.fileId,
+        expiresIn: args.expiresIn,
+    })));
+}
+//# sourceMappingURL=storage.js.map

package/dist/tools/storage.js.map

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

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "mudbase-mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server that exposes Mudbase's database, storage, and search capabilities as tools for Claude Code and other MCP clients, gated by a Mudbase API key.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Mudbase Team",
+  "homepage": "https://mudbase.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/themudhaxk/mudbase-mcp-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/themudhaxk/mudbase-mcp-server/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "mudbase",
+    "baas",
+    "claude",
+    "claude-code",
+    "database",
+    "storage"
+  ],
+  "bin": {
+    "mudbase-mcp-server": "dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src test --ext .ts"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "axios": "^1.7.9",
+    "form-data": "^4.0.1",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "@typescript-eslint/eslint-plugin": "^8.19.1",
+    "@typescript-eslint/parser": "^8.19.1",
+    "eslint": "^8.57.1",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3",
+    "vitest": "^3.2.7"
+  }
+}