@adrive/mcp-server 0.3.0

package/dist/tools/drive-read.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import type { ApiClient } from '../api-client.js';
+export declare const driveReadSchema: {
+    workspace_id: z.ZodString;
+    file_id: z.ZodString;
+};
+export declare function driveRead(client: ApiClient, args: {
+    workspace_id: string;
+    file_id: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/tools/drive-read.js

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+export const driveReadSchema = {
+    workspace_id: z.string().describe('Workspace ID'),
+    file_id: z.string().describe('File ID to read'),
+};
+export async function driveRead(client, args) {
+    const file = await client.readFile(args.workspace_id, args.file_id);
+    return {
+        content: [{
+                type: 'text',
+                text: `# ${file.path} (v${file.version})\n\n${file.content}`,
+            }],
+    };
+}

package/dist/tools/drive-recall.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import type { ApiClient } from '../api-client.js';
+export declare const driveRecallSchema: {
+    query: z.ZodString;
+    top_k: z.ZodOptional<z.ZodNumber>;
+};
+export declare function driveRecall(client: ApiClient, args: {
+    query: string;
+    top_k?: number;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/tools/drive-recall.js

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+export const driveRecallSchema = {
+    query: z.string().min(1).max(2000).describe('Recall query — what fact, preference, or decision are you trying to remember?'),
+    top_k: z.number().int().positive().max(20).optional().describe('Max results (default 5, max 20)'),
+};
+export async function driveRecall(client, args) {
+    // v1 narrows nothing; v1.5 will scope to filter.kind === 'fact' once the fact-extractor lands.
+    const { hits } = await client.search({
+        query: args.query,
+        top_k: args.top_k ?? 5,
+    });
+    if (hits.length === 0) {
+        return { content: [{ type: 'text', text: 'Nothing recalled.' }] };
+    }
+    return {
+        content: [{ type: 'text', text: hits.map(formatHit).join('\n---\n') }],
+    };
+}
+function formatHit(h) {
+    const score = h.score.toFixed(2);
+    const snippet = truncate(h.snippet ?? '', 200);
+    const created = new Date(h.created_at).toISOString();
+    return `${h.path}\nws=${h.ws_id} · score=${score} · by=${h.agent_id}@${h.agent_platform} · ${created}\n${snippet}`;
+}
+function truncate(s, n) {
+    if (s.length <= n)
+        return s;
+    return s.slice(0, n - 1) + '...';
+}

package/dist/tools/drive-roles.d.ts

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+import type { ApiClient } from '../api-client.js';
+export declare const driveRolesSchema: {
+    workspace_id: z.ZodString;
+    action: z.ZodEnum<["assign", "list", "remove"]>;
+    email: z.ZodOptional<z.ZodString>;
+    permission: z.ZodOptional<z.ZodEnum<["view", "comment", "edit"]>>;
+};
+export declare function driveRoles(client: ApiClient, args: {
+    workspace_id: string;
+    action: 'assign' | 'list' | 'remove';
+    email?: string;
+    permission?: 'view' | 'comment' | 'edit';
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/tools/drive-roles.js

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+export const driveRolesSchema = {
+    workspace_id: z.string().describe('Workspace ID'),
+    action: z.enum(['assign', 'list', 'remove']).describe('Action: assign a role, list all roles, or remove a role'),
+    email: z.string().optional().describe('Email address (required for assign/remove)'),
+    permission: z.enum(['view', 'comment', 'edit']).optional().describe('Permission level (required for assign)'),
+};
+export async function driveRoles(client, args) {
+    if (args.action === 'list') {
+        const roles = await client.getAllRoles(args.workspace_id);
+        if (roles.length === 0) {
+            return { content: [{ type: 'text', text: 'No roles assigned in this workspace.' }] };
+        }
+        const listing = roles.map(r => `- ${r.email}: ${r.permission} (assigned by ${r.assigned_by} on ${r.assigned_at})`).join('\n');
+        return { content: [{ type: 'text', text: `Workspace roles:\n${listing}` }] };
+    }
+    if (args.action === 'assign') {
+        if (!args.email || !args.permission) {
+            return { content: [{ type: 'text', text: 'Error: email and permission are required for assign action.' }] };
+        }
+        const role = await client.assignRole(args.workspace_id, args.email, args.permission);
+        return { content: [{ type: 'text', text: `Assigned ${args.permission} access to ${args.email} in workspace.` }] };
+    }
+    if (args.action === 'remove') {
+        if (!args.email) {
+            return { content: [{ type: 'text', text: 'Error: email is required for remove action.' }] };
+        }
+        await client.removeRole(args.workspace_id, args.email);
+        return { content: [{ type: 'text', text: `Removed ${args.email}'s role from workspace.` }] };
+    }
+    return { content: [{ type: 'text', text: 'Unknown action.' }] };
+}

package/dist/tools/drive-search.d.ts

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+import type { ApiClient } from '../api-client.js';
+declare const AGENT_PLATFORMS: readonly ["claude-code", "codex", "cursor", "langgraph", "crewai", "autogen", "hermes", "openclaw", "unknown"];
+export declare const driveSearchSchema: {
+    query: z.ZodString;
+    workspace_id: z.ZodOptional<z.ZodString>;
+    top_k: z.ZodOptional<z.ZodNumber>;
+    filter: z.ZodOptional<z.ZodObject<{
+        agent_platform: z.ZodOptional<z.ZodEnum<["claude-code", "codex", "cursor", "langgraph", "crewai", "autogen", "hermes", "openclaw", "unknown"]>>;
+        agent_id: z.ZodOptional<z.ZodString>;
+        path_prefix: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        agent_platform?: "claude-code" | "cursor" | "codex" | "langgraph" | "crewai" | "autogen" | "hermes" | "openclaw" | "unknown" | undefined;
+        agent_id?: string | undefined;
+        path_prefix?: string | undefined;
+    }, {
+        agent_platform?: "claude-code" | "cursor" | "codex" | "langgraph" | "crewai" | "autogen" | "hermes" | "openclaw" | "unknown" | undefined;
+        agent_id?: string | undefined;
+        path_prefix?: string | undefined;
+    }>>;
+};
+export declare function driveSearch(client: ApiClient, args: {
+    query: string;
+    workspace_id?: string;
+    top_k?: number;
+    filter?: {
+        agent_platform?: typeof AGENT_PLATFORMS[number];
+        agent_id?: string;
+        path_prefix?: string;
+    };
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export {};

package/dist/tools/drive-search.js

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+const AGENT_PLATFORMS = [
+    'claude-code',
+    'codex',
+    'cursor',
+    'langgraph',
+    'crewai',
+    'autogen',
+    'hermes',
+    'openclaw',
+    'unknown',
+];
+export const driveSearchSchema = {
+    query: z.string().min(1).max(2000).describe('Search query'),
+    workspace_id: z.string().optional().describe('Scope to a single workspace; omit for org-wide search'),
+    top_k: z.number().int().positive().max(50).optional().describe('Max hits to return (default 10, max 50)'),
+    filter: z.object({
+        agent_platform: z.enum(AGENT_PLATFORMS).optional(),
+        agent_id: z.string().optional(),
+        path_prefix: z.string().optional(),
+    }).optional(),
+};
+export async function driveSearch(client, args) {
+    const { hits } = await client.search({
+        query: args.query,
+        workspace_id: args.workspace_id,
+        top_k: args.top_k ?? 10,
+        filter: args.filter,
+    });
+    if (hits.length === 0) {
+        return { content: [{ type: 'text', text: 'No matches.' }] };
+    }
+    return {
+        content: [{ type: 'text', text: hits.map(formatHit).join('\n---\n') }],
+    };
+}
+function formatHit(h) {
+    const score = h.score.toFixed(2);
+    const snippet = truncate(h.snippet ?? '', 200);
+    const created = new Date(h.created_at).toISOString();
+    return `${h.path}\nws=${h.ws_id} · score=${score} · by=${h.agent_id}@${h.agent_platform} · ${created}\n${snippet}`;
+}
+function truncate(s, n) {
+    if (s.length <= n)
+        return s;
+    return s.slice(0, n - 1) + '...';
+}

package/dist/tools/drive-share.d.ts

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+import type { ApiClient } from '../api-client.js';
+export declare const driveShareSchema: {
+    workspace_id: z.ZodString;
+    permission: z.ZodEnum<["view", "comment", "edit"]>;
+    file_id: z.ZodOptional<z.ZodString>;
+    expires_in: z.ZodOptional<z.ZodNumber>;
+    max_uses: z.ZodOptional<z.ZodNumber>;
+    email: z.ZodOptional<z.ZodString>;
+};
+export declare function driveShare(client: ApiClient, args: {
+    workspace_id: string;
+    permission: 'view' | 'comment' | 'edit';
+    file_id?: string;
+    expires_in?: number;
+    max_uses?: number;
+    email?: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/tools/drive-share.js

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+export const driveShareSchema = {
+    workspace_id: z.string().describe('Workspace ID'),
+    permission: z.enum(['view', 'comment', 'edit']).describe('Permission level for the share link'),
+    file_id: z.string().optional().describe('Scope to a specific file (optional)'),
+    expires_in: z.number().optional().describe('Expiry in seconds (optional)'),
+    max_uses: z.number().optional().describe('Maximum number of uses (optional)'),
+    email: z.string().optional().describe('Email-gate: only this email can access the link (requires email verification). Leave empty for public access.'),
+};
+export async function driveShare(client, args) {
+    const share = await client.createShareLink(args.workspace_id, args.permission, args.file_id, args.expires_in, args.max_uses, args.email);
+    const emailNote = share.email_gated
+        ? `\nEmail-gated: only ${args.email} can access (they'll verify via magic code)`
+        : '\nPublic: anyone with the link can access';
+    return {
+        content: [{
+                type: 'text',
+                text: `Share link created (${share.permission} access):\n${share.url}${emailNote}${share.expires_at ? `\nExpires: ${share.expires_at}` : ''}`,
+            }],
+    };
+}

package/dist/tools/drive-versions.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import type { ApiClient } from '../api-client.js';
+export declare const driveVersionsSchema: {
+    workspace_id: z.ZodString;
+    file_id: z.ZodString;
+};
+export declare function driveVersions(client: ApiClient, args: {
+    workspace_id: string;
+    file_id: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/tools/drive-versions.js

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export const driveVersionsSchema = {
+    workspace_id: z.string().describe('Workspace ID'),
+    file_id: z.string().describe('File ID'),
+};
+export async function driveVersions(client, args) {
+    const versions = await client.getAllVersions(args.workspace_id, args.file_id);
+    if (versions.length === 0) {
+        return { content: [{ type: 'text', text: 'No version history found.' }] };
+    }
+    const lines = versions.map(v => `v${v.version} | ${v.actor_type}:${v.actor_id} | ${v.created_at}${v.message ? ` | "${v.message}"` : ''}`);
+    return { content: [{ type: 'text', text: `Version history (${versions.length} versions):\n${lines.join('\n')}` }] };
+}

package/dist/tools/drive-write.d.ts

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+import type { ApiClient } from '../api-client.js';
+export declare const driveWriteSchema: {
+    workspace_id: z.ZodString;
+    path: z.ZodString;
+    content: z.ZodString;
+    message: z.ZodOptional<z.ZodString>;
+};
+export declare function driveWrite(client: ApiClient, args: {
+    workspace_id: string;
+    path: string;
+    content: string;
+    message?: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/tools/drive-write.js

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+export const driveWriteSchema = {
+    workspace_id: z.string().describe('Workspace ID to write to'),
+    path: z.string().describe('File path (e.g. "notes/meeting.md")'),
+    content: z.string().describe('File content (markdown)'),
+    message: z.string().optional().describe('Optional version message'),
+};
+export async function driveWrite(client, args) {
+    const file = await client.writeFile(args.workspace_id, args.path, args.content, args.message);
+    return {
+        content: [{
+                type: 'text',
+                text: `File written: ${file.path} (v${file.version}, id: ${file.id})`,
+            }],
+    };
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@adrive/mcp-server",
+  "version": "0.3.0",
+  "description": "MCP server for AgentDrive — the persistent workspace your agents share across Claude Code, Codex, Cursor, and LangGraph. Files, semantic search, run logging, and cross-platform memory.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "bin": {
+    "adrive-mcp": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "homepage": "https://agentdrive.sh",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Rakesh1002/agentdrive.git",
+    "directory": "packages/mcp-server"
+  },
+  "bugs": {
+    "url": "https://github.com/Rakesh1002/agentdrive/issues"
+  },
+  "keywords": [
+    "agentdrive",
+    "mcp",
+    "model-context-protocol",
+    "agent",
+    "ai-agent",
+    "claude-code",
+    "codex",
+    "cursor",
+    "langgraph"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  }
+}