addai-drive-mcp 0.1.0

package/dist/client.d.ts

@@ -0,0 +1,25 @@
+export interface StorageError {
+    message: string;
+    code?: string;
+}
+export declare class DriveClient {
+    private baseUrl;
+    private apiKey;
+    constructor(apiKey: string, baseUrl?: string);
+    private headers;
+    get<T = unknown>(fn: string, params?: Record<string, string | undefined>): Promise<{
+        data?: T;
+        error?: StorageError;
+    }>;
+    post<T = unknown>(fn: string, body: unknown): Promise<{
+        data?: T;
+        error?: StorageError;
+    }>;
+    getBytes(fn: string, params?: Record<string, string | undefined>): Promise<{
+        bytes?: Uint8Array;
+        contentType?: string;
+        error?: StorageError;
+    }>;
+    private parse;
+}
+//# 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":"AAQA,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAK5C,OAAO,CAAC,OAAO;IAQT,GAAG,CAAC,CAAC,GAAG,OAAO,EACnB,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAC1C,OAAO,CAAC;QAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,YAAY,CAAA;KAAE,CAAC;IAexC,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC;QAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,YAAY,CAAA;KAAE,CAAC;IAUxC,QAAQ,CACZ,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAC1C,OAAO,CAAC;QAAE,KAAK,CAAC,EAAE,UAAU,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,YAAY,CAAA;KAAE,CAAC;YAmBhE,KAAK;CAkBpB"}

package/dist/client.js

@@ -0,0 +1,86 @@
+// Thin client over the +Ai Drive (addai-storage) edge functions. Each storage
+// operation is its own function under the project's functions base URL, so
+// unlike a single REST API we address each function by name. Auth is the
+// entity's API key in the x-api-key header (the same key the runtime mints).
+const DEFAULT_BASE_URL = 'https://syhzpqqvrplaqdipcymw.supabase.co/functions/v1';
+export class DriveClient {
+    baseUrl;
+    apiKey;
+    constructor(apiKey, baseUrl) {
+        this.apiKey = apiKey;
+        this.baseUrl = (baseUrl || DEFAULT_BASE_URL).replace(/\/+$/, '');
+    }
+    headers() {
+        return {
+            'x-api-key': this.apiKey,
+            'Content-Type': 'application/json',
+        };
+    }
+    // GET a storage function with query params, parsing JSON.
+    async get(fn, params) {
+        let url = `${this.baseUrl}/${fn}`;
+        if (params) {
+            const sp = new URLSearchParams();
+            for (const [k, v] of Object.entries(params)) {
+                if (v !== undefined && v !== '')
+                    sp.set(k, v);
+            }
+            const qs = sp.toString();
+            if (qs)
+                url += `?${qs}`;
+        }
+        const res = await fetch(url, { method: 'GET', headers: this.headers() });
+        return this.parse(res);
+    }
+    // POST a storage function with a JSON body, parsing JSON.
+    async post(fn, body) {
+        const res = await fetch(`${this.baseUrl}/${fn}`, {
+            method: 'POST',
+            headers: this.headers(),
+            body: JSON.stringify(body),
+        });
+        return this.parse(res);
+    }
+    // GET raw bytes (used by read_file via storage-download?proxy=1).
+    async getBytes(fn, params) {
+        let url = `${this.baseUrl}/${fn}`;
+        if (params) {
+            const sp = new URLSearchParams();
+            for (const [k, v] of Object.entries(params)) {
+                if (v !== undefined && v !== '')
+                    sp.set(k, v);
+            }
+            const qs = sp.toString();
+            if (qs)
+                url += `?${qs}`;
+        }
+        const res = await fetch(url, { method: 'GET', headers: { 'x-api-key': this.apiKey } });
+        if (!res.ok) {
+            const txt = await res.text().catch(() => '');
+            return { error: { message: txt || `Request failed (${res.status})`, code: String(res.status) } };
+        }
+        const buf = new Uint8Array(await res.arrayBuffer());
+        return { bytes: buf, contentType: res.headers.get('content-type') || undefined };
+    }
+    async parse(res) {
+        let json = {};
+        try {
+            json = (await res.json());
+        }
+        catch {
+            if (!res.ok)
+                return { error: { message: `Request failed (${res.status})`, code: String(res.status) } };
+        }
+        if (!res.ok || (json && json.error)) {
+            const err = json.error;
+            return {
+                error: {
+                    message: err?.message || `Request failed (${res.status})`,
+                    code: String(res.status),
+                },
+            };
+        }
+        return { data: json };
+    }
+}
+//# 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/errors.d.ts

@@ -0,0 +1,14 @@
+export declare function mcpError(message: string): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+};
+export declare function mcpResult(data: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAGA,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM;;;;;;EAKvC;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO;;;;;EAKtC"}

package/dist/errors.js

@@ -0,0 +1,15 @@
+// MCP tool result helpers — mirror the aitables-mcp shapes so tool output is
+// consistent across +Ai MCP servers.
+export function mcpError(message) {
+    return {
+        content: [{ type: 'text', text: `Error: ${message}` }],
+        isError: true,
+    };
+}
+export function mcpResult(data) {
+    const text = typeof data === 'string' ? data : JSON.stringify(data, null, 2);
+    return {
+        content: [{ type: 'text', text }],
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,qCAAqC;AAErC,MAAM,UAAU,QAAQ,CAAC,OAAe;IACtC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;QAC/D,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,MAAM,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7E,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;KAC3C,CAAC;AACJ,CAAC"}

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,29 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer } from './server.js';
+const apiKey = process.env.ADDAI_DRIVE_API_KEY;
+const workspaceId = process.env.ADDAI_DRIVE_WORKSPACE_ID;
+const rootFolderId = process.env.ADDAI_DRIVE_FOLDER_ID;
+if (!apiKey || !workspaceId || !rootFolderId) {
+    console.error('Error: +Ai Drive MCP requires ADDAI_DRIVE_API_KEY, ADDAI_DRIVE_WORKSPACE_ID, and ADDAI_DRIVE_FOLDER_ID.\n\n' +
+        'These are provisioned automatically when the +Ai Drive app is added to an entity. Example .mcp.json:\n' +
+        '  {\n' +
+        '    "mcpServers": {\n' +
+        '      "addai-drive": {\n' +
+        '        "command": "npx",\n' +
+        '        "args": ["-y", "addai-drive-mcp"],\n' +
+        '        "env": {\n' +
+        '          "ADDAI_DRIVE_API_KEY": "ait_ent_xxxx",\n' +
+        '          "ADDAI_DRIVE_WORKSPACE_ID": "<workspace uuid>",\n' +
+        '          "ADDAI_DRIVE_FOLDER_ID": "<your drive root folder uuid>"\n' +
+        '        }\n' +
+        '      }\n' +
+        '    }\n' +
+        '  }');
+    process.exit(1);
+}
+const baseUrl = process.env.ADDAI_DRIVE_API_URL || undefined;
+const server = createServer({ apiKey, workspaceId, rootFolderId, baseUrl });
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;AAC/C,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC;AACzD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;AAEvD,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW,IAAI,CAAC,YAAY,EAAE,CAAC;IAC7C,OAAO,CAAC,KAAK,CACX,6GAA6G;QAC3G,wGAAwG;QACxG,OAAO;QACP,uBAAuB;QACvB,0BAA0B;QAC1B,6BAA6B;QAC7B,8CAA8C;QAC9C,oBAAoB;QACpB,oDAAoD;QACpD,6DAA6D;QAC7D,sEAAsE;QACtE,aAAa;QACb,WAAW;QACX,SAAS;QACT,KAAK,CACR,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,SAAS,CAAC;AAC7D,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,CAAC;AAC5E,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,9 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export interface DriveConfig {
+    apiKey: string;
+    workspaceId: string;
+    rootFolderId: string;
+    baseUrl?: string;
+}
+export declare function createServer(config: DriveConfig): 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;AAKpE,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAsBD,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CA0N3D"}

package/dist/server.js

@@ -0,0 +1,183 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { DriveClient } from './client.js';
+import { mcpError, mcpResult } from './errors.js';
+const SERVER_INSTRUCTIONS = `You are connected to +Ai Drive — your own persistent file storage. Everything you save here lives in YOUR folder and is available every time you run, so use it as your long-term memory and working storage for documents, notes, data exports, and any files you produce.
+
+## Your folder
+All your files live under one root folder (your "Drive"). list_files with no folder_id shows the root. Folders can nest — make_folder creates subfolders to stay organised (e.g. "reports", "drafts", "data").
+
+## Reading & writing
+- **list_files** — see what you already have (subfolders + files). Do this first so you don't duplicate work.
+- **read_file** — read a text file's contents by id.
+- **write_file** — save text content as a file (markdown, notes, JSON, CSV, code). This is the main way you create files.
+- **upload_file** — save binary content (base64) when you have non-text bytes.
+
+## Organising
+- **make_folder** — create a subfolder. **rename_file / rename_folder** — rename. **move_files** — move files into a folder. **delete_files / delete_folder** — remove things (deletes are permanent).
+- **search_files** — find a file by name across your Drive.
+
+## Habits
+1. At the start of a task, list_files to recall what you already have.
+2. Save anything worth keeping with write_file — don't lose work between runs.
+3. Keep a tidy structure with folders; put a file's id in your notes if you'll need it again.`;
+export function createServer(config) {
+    const server = new McpServer({ name: 'addai-drive-mcp', version: '0.1.0' }, { instructions: SERVER_INSTRUCTIONS });
+    const client = new DriveClient(config.apiKey, config.baseUrl);
+    const { workspaceId, rootFolderId } = config;
+    // ── list_files ──
+    server.tool('list_files', "List the subfolders and files in one of your Drive folders. Omit folder_id to list your Drive root. Returns folders[] and files[] (each file has id, name, type, size, folderId).", {
+        folder_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Folder to list. Omit for your Drive root.'),
+    }, async ({ folder_id }) => {
+        const res = await client.get('storage-list', {
+            workspaceId,
+            folderId: folder_id || rootFolderId,
+        });
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult(res.data);
+    });
+    // ── read_file ──
+    server.tool('read_file', 'Read the contents of a text file in your Drive by its id. Returns the decoded text. For binary files this may be unreadable — use it for text/markdown/JSON/CSV/code.', {
+        file_id: z.string().uuid().describe('The id of the file to read'),
+    }, async ({ file_id }) => {
+        const res = await client.getBytes('storage-download', { fileId: file_id, proxy: '1' });
+        if (res.error)
+            return mcpError(res.error.message);
+        const text = Buffer.from(res.bytes ?? new Uint8Array()).toString('utf-8');
+        return mcpResult(text);
+    });
+    // ── write_file ──
+    server.tool('write_file', 'Save text content as a file in your Drive (markdown, notes, JSON, CSV, code, etc). Creates a new file. Omit folder_id to save in your Drive root.', {
+        file_name: z.string().min(1).describe('File name, e.g. "summary.md" or "data.json"'),
+        content: z.string().describe('The text content to write'),
+        folder_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Folder to save into. Omit for your Drive root.'),
+        content_type: z
+            .string()
+            .optional()
+            .describe('MIME type. Defaults to text/plain (use text/markdown, application/json, text/csv as appropriate).'),
+    }, async ({ file_name, content, folder_id, content_type }) => {
+        const base64Data = Buffer.from(content, 'utf-8').toString('base64');
+        const res = await client.post('storage-upload', {
+            base64Data,
+            fileName: file_name,
+            contentType: content_type || 'text/plain',
+            sourceApp: 'direct_upload',
+            sourceKind: 'entity_file',
+            folderId: folder_id || rootFolderId,
+            workspaceId,
+        });
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult(res.data);
+    });
+    // ── upload_file ──
+    server.tool('upload_file', 'Save binary content (provided as base64) as a file in your Drive — use for images, PDFs, or any non-text bytes. For text, prefer write_file.', {
+        file_name: z.string().min(1).describe('File name including extension'),
+        base64_data: z.string().min(1).describe('File bytes encoded as base64'),
+        content_type: z.string().min(1).describe('MIME type, e.g. image/png or application/pdf'),
+        folder_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Folder to save into. Omit for your Drive root.'),
+    }, async ({ file_name, base64_data, content_type, folder_id }) => {
+        const res = await client.post('storage-upload', {
+            base64Data: base64_data,
+            fileName: file_name,
+            contentType: content_type,
+            sourceApp: 'direct_upload',
+            sourceKind: 'entity_file',
+            folderId: folder_id || rootFolderId,
+            workspaceId,
+        });
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult(res.data);
+    });
+    // ── make_folder ──
+    server.tool('make_folder', 'Create a subfolder in your Drive to organise files. Omit parent_id to create it at your Drive root, or nest it under an existing folder.', {
+        name: z.string().min(1).describe('Folder name'),
+        parent_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Parent folder. Omit for your Drive root.'),
+    }, async ({ name, parent_id }) => {
+        const res = await client.post('storage-folder', {
+            op: 'create',
+            name,
+            parentId: parent_id || rootFolderId,
+        });
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult(res.data);
+    });
+    // ── rename_file ──
+    server.tool('rename_file', 'Rename a file in your Drive.', {
+        file_id: z.string().uuid().describe('The file to rename'),
+        name: z.string().min(1).describe('New file name'),
+    }, async ({ file_id, name }) => {
+        const res = await client.post('storage-rename', { fileId: file_id, name });
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult(res.data);
+    });
+    // ── rename_folder ──
+    server.tool('rename_folder', 'Rename a folder in your Drive.', {
+        folder_id: z.string().uuid().describe('The folder to rename'),
+        name: z.string().min(1).describe('New folder name'),
+    }, async ({ folder_id, name }) => {
+        const res = await client.post('storage-folder', { op: 'rename', folderId: folder_id, name });
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult(res.data);
+    });
+    // ── move_files ──
+    server.tool('move_files', 'Move one or more files into a folder in your Drive. Pass folder_id = your Drive root to move them back to the top level.', {
+        file_ids: z.array(z.string().uuid()).min(1).describe('The files to move'),
+        folder_id: z.string().uuid().describe('Destination folder id'),
+    }, async ({ file_ids, folder_id }) => {
+        const res = await client.post('storage-move', { fileIds: file_ids, folderId: folder_id });
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult(res.data);
+    });
+    // ── delete_files ──
+    server.tool('delete_files', 'Permanently delete one or more files from your Drive. This cannot be undone.', {
+        file_ids: z.array(z.string().uuid()).min(1).describe('The files to delete'),
+    }, async ({ file_ids }) => {
+        const res = await client.post('storage-delete', { fileIds: file_ids });
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult(res.data);
+    });
+    // ── delete_folder ──
+    server.tool('delete_folder', 'Delete an (empty) folder from your Drive. Move or delete its contents first.', {
+        folder_id: z.string().uuid().describe('The folder to delete'),
+    }, async ({ folder_id }) => {
+        const res = await client.post('storage-folder', { op: 'delete', folderId: folder_id });
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult({ message: 'Folder deleted' });
+    });
+    // ── search_files ──
+    server.tool('search_files', 'Search your Drive for files by name/text. Returns matching files across all your folders.', {
+        query: z.string().min(1).describe('Search term'),
+    }, async ({ query }) => {
+        const res = await client.get('storage-search', { workspaceId, query });
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult(res.data);
+    });
+    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":"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"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "addai-drive-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for +Ai Drive — lets an +Ai entity store, read, and manage files in its own Drive folder",
+  "type": "module",
+  "bin": {
+    "addai-drive-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "claude",
+    "addai",
+    "drive",
+    "storage",
+    "files",
+    "model-context-protocol"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.24.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.3",
+    "typescript": "^5.8.3"
+  }
+}