@doxhub/mcp-server 0.1.0

package/dist/tools/get-project-structure.js

@@ -0,0 +1,37 @@
+import { getProjectStructure as getProjectStructureQuery } from '../queries/workspace-queries.js';
+export const getProjectStructureTool = {
+    name: 'get_project_structure',
+    description: 'Get the complete hierarchical structure of a project\'s documentation. Shows all folders and files organized by their relationship. Use this to understand how documentation is organized.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            projectId: {
+                type: 'string',
+                description: 'The UUID of the project',
+            },
+            includeArchived: {
+                type: 'boolean',
+                description: 'Include archived files in the structure (default: false)',
+            },
+        },
+        required: ['projectId'],
+    },
+};
+export async function getProjectStructure(auth, args) {
+    const { projectId, includeArchived = false } = args;
+    if (!projectId || typeof projectId !== 'string') {
+        throw new Error('projectId parameter is required and must be a string');
+    }
+    const results = await getProjectStructureQuery(auth, projectId, {
+        includeArchived,
+    });
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(results, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=get-project-structure.js.map

package/dist/tools/get-project-structure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-project-structure.js","sourceRoot":"","sources":["../../src/tools/get-project-structure.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,IAAI,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAElG,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EACT,4LAA4L;IAC9L,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yBAAyB;aACvC;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,0DAA0D;aACxE;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAiB,EAAE,IAAS;IACpE,MAAM,EAAE,SAAS,EAAE,eAAe,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC;IAEpD,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,wBAAwB,CAAC,IAAI,EAAE,SAAS,EAAE;QAC9D,eAAe;KAChB,CAAC,CAAC;IAEH,OAAO;QACL,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"}

package/dist/tools/index.d.ts

@@ -0,0 +1,8 @@
+export * from './search-documentation.js';
+export * from './get-file.js';
+export * from './list-files.js';
+export * from './list-projects.js';
+export * from './get-file-versions.js';
+export * from './get-project-structure.js';
+export * from './list-workspaces.js';
+//# 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,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,8 @@
+export * from './search-documentation.js';
+export * from './get-file.js';
+export * from './list-files.js';
+export * from './list-projects.js';
+export * from './get-file-versions.js';
+export * from './get-project-structure.js';
+export * from './list-workspaces.js';
+//# 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":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC"}

package/dist/tools/list-files.d.ts

@@ -0,0 +1,35 @@
+import type { AuthContext } from '../types.js';
+export declare const listFilesTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            projectId: {
+                type: string;
+                description: string;
+            };
+            folderId: {
+                type: string[];
+                description: string;
+            };
+            status: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function listFiles(auth: AuthContext, args: any): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=list-files.d.ts.map

package/dist/tools/list-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-files.d.ts","sourceRoot":"","sources":["../../src/tools/list-files.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BzB,CAAC;AAEF,wBAAsB,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG;;;;;GAoD3D"}

package/dist/tools/list-files.js

@@ -0,0 +1,74 @@
+import { listFiles as listFilesQuery } from '../queries/file-queries.js';
+export const listFilesTool = {
+    name: 'list_files',
+    description: 'Lists files in a project or folder (names and metadata only, no content). Use get_file to retrieve specific file content.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            projectId: {
+                type: 'string',
+                description: 'Required: Project ID to list files from',
+            },
+            folderId: {
+                type: ['string', 'null'],
+                description: 'Optional: filter by folder ID (null for root files, omit for all files)',
+            },
+            status: {
+                type: 'string',
+                enum: ['active', 'archived'],
+                description: 'Filter by file status (default: active)',
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum number of results to return (default: 50, max: 100)',
+            },
+        },
+        required: ['projectId'],
+    },
+};
+export async function listFiles(auth, args) {
+    const { projectId, folderId, status, limit = 50 } = args;
+    const results = await listFilesQuery(auth, {
+        projectId,
+        folderId,
+        status,
+        limit,
+        offset: 0,
+    });
+    const files = results.files || [];
+    if (files.length === 0) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'No files found in this project.',
+                },
+            ],
+        };
+    }
+    // Format as clean summary without content
+    let output = `📄 Files in Project (${files.length} total)\n\n`;
+    files.forEach((file, index) => {
+        const contentSize = file.content ? file.content.length : 0;
+        const sizeKB = (contentSize / 1024).toFixed(1);
+        output += `${index + 1}. **${file.title}**\n`;
+        output += `   ID: ${file.id}\n`;
+        output += `   Path: ${file.path}\n`;
+        output += `   Size: ${sizeKB} KB\n`;
+        output += `   Updated: ${file.updatedAt?.substring(0, 10) || 'Unknown'}\n`;
+        if (file.status === 'archived') {
+            output += `   Status: 🗄️ Archived\n`;
+        }
+        output += '\n';
+    });
+    output += `💡 Use get_file with a file ID to retrieve the full content of a specific file.`;
+    return {
+        content: [
+            {
+                type: 'text',
+                text: output,
+            },
+        ],
+    };
+}
+//# sourceMappingURL=list-files.js.map

package/dist/tools/list-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-files.js","sourceRoot":"","sources":["../../src/tools/list-files.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,IAAI,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEzE,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,2HAA2H;IAC7H,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yCAAyC;aACvD;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;gBACxB,WAAW,EACT,yEAAyE;aAC5E;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC;gBAC5B,WAAW,EAAE,yCAAyC;aACvD;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6DAA6D;aAC3E;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAiB,EAAE,IAAS;IAC1D,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC;IAEzD,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE;QACzC,SAAS;QACT,QAAQ;QACR,MAAM;QACN,KAAK;QACL,MAAM,EAAE,CAAC;KACV,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;IAElC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,iCAAiC;iBACxC;aACF;SACF,CAAC;IACJ,CAAC;IAED,0CAA0C;IAC1C,IAAI,MAAM,GAAG,wBAAwB,KAAK,CAAC,MAAM,aAAa,CAAC;IAE/D,KAAK,CAAC,OAAO,CAAC,CAAC,IAAS,EAAE,KAAa,EAAE,EAAE;QACzC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3D,MAAM,MAAM,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAE/C,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,OAAO,IAAI,CAAC,KAAK,MAAM,CAAC;QAC9C,MAAM,IAAI,UAAU,IAAI,CAAC,EAAE,IAAI,CAAC;QAChC,MAAM,IAAI,YAAY,IAAI,CAAC,IAAI,IAAI,CAAC;QACpC,MAAM,IAAI,YAAY,MAAM,OAAO,CAAC;QACpC,MAAM,IAAI,eAAe,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,SAAS,IAAI,CAAC;QAC3E,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YAC/B,MAAM,IAAI,2BAA2B,CAAC;QACxC,CAAC;QACD,MAAM,IAAI,IAAI,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,iFAAiF,CAAC;IAE5F,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,MAAM;aACb;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/list-projects.d.ts

@@ -0,0 +1,19 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { AuthContext } from '../types.js';
+export declare const listProjectsTool: Tool;
+export declare function listProjects(auth: AuthContext, args: {
+    workspaceId?: string;
+}): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError?: never;
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+//# sourceMappingURL=list-projects.d.ts.map

package/dist/tools/list-projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-projects.d.ts","sourceRoot":"","sources":["../../src/tools/list-projects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,eAAO,MAAM,gBAAgB,EAAE,IAY9B,CAAC;AAEF,wBAAsB,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;GAgEnF"}

package/dist/tools/list-projects.js

@@ -0,0 +1,74 @@
+import { getApiClient } from '../api-client.js';
+export const listProjectsTool = {
+    name: 'list_projects',
+    description: 'Lists all projects in a workspace with file counts. Use this to see what projects you have before listing files.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            workspaceId: {
+                type: 'string',
+                description: 'Workspace ID. If not provided, uses your default workspace.',
+            },
+        },
+    },
+};
+export async function listProjects(auth, args) {
+    const apiClient = getApiClient();
+    const workspaceId = args.workspaceId || auth.workspaceId;
+    if (!workspaceId) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'No workspace specified. Please provide a workspaceId or select a default workspace.',
+                },
+            ],
+        };
+    }
+    try {
+        const projects = await apiClient.getProjects(workspaceId);
+        if (!projects || projects.length === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'No projects found in this workspace.',
+                    },
+                ],
+            };
+        }
+        // Format as a clean summary
+        let output = `📂 Projects in Workspace (${projects.length} total)\n\n`;
+        projects.forEach((project, index) => {
+            output += `${index + 1}. **${project.name}**\n`;
+            output += `   ID: ${project.id}\n`;
+            output += `   Files: ${project.fileCount || 0}\n`;
+            output += `   Folders: ${project.folderCount || 0}\n`;
+            if (project.description) {
+                output += `   Description: ${project.description}\n`;
+            }
+            output += '\n';
+        });
+        output += `💡 Use list_files with a project ID to see files in a project.`;
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: output,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error listing projects: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=list-projects.js.map

package/dist/tools/list-projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-projects.js","sourceRoot":"","sources":["../../src/tools/list-projects.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,kHAAkH;IAC/H,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6DAA6D;aAC3E;SACF;KACF;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAiB,EAAE,IAA8B;IAClF,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC;IAEzD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,qFAAqF;iBAC5F;aACF;SACF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QAE1D,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,sCAAsC;qBAC7C;iBACF;aACF,CAAC;QACJ,CAAC;QAED,4BAA4B;QAC5B,IAAI,MAAM,GAAG,6BAA6B,QAAQ,CAAC,MAAM,aAAa,CAAC;QAEvE,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAY,EAAE,KAAa,EAAE,EAAE;YAC/C,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,OAAO,OAAO,CAAC,IAAI,MAAM,CAAC;YAChD,MAAM,IAAI,UAAU,OAAO,CAAC,EAAE,IAAI,CAAC;YACnC,MAAM,IAAI,aAAa,OAAO,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC;YAClD,MAAM,IAAI,eAAe,OAAO,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC;YACtD,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;gBACxB,MAAM,IAAI,mBAAmB,OAAO,CAAC,WAAW,IAAI,CAAC;YACvD,CAAC;YACD,MAAM,IAAI,IAAI,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,gEAAgE,CAAC;QAE3E,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,MAAM;iBACb;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,2BAA2B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE;iBAC5F;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/list-workspaces.d.ts

@@ -0,0 +1,17 @@
+import type { AuthContext } from '../types.js';
+export declare const listWorkspacesTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {};
+        required: never[];
+    };
+};
+export declare function listWorkspaces(auth: AuthContext, _args: any): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=list-workspaces.d.ts.map

package/dist/tools/list-workspaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-workspaces.d.ts","sourceRoot":"","sources":["../../src/tools/list-workspaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,eAAO,MAAM,kBAAkB;;;;;;;;CAS9B,CAAC;AAEF,wBAAsB,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG;;;;;GAuCjE"}

package/dist/tools/list-workspaces.js

@@ -0,0 +1,45 @@
+import { listWorkspaces as listWorkspacesQuery } from '../queries/workspace-queries.js';
+export const listWorkspacesTool = {
+    name: 'list_workspaces',
+    description: 'Lists all workspaces you have access to with your role. Use list_projects to see projects in a workspace.',
+    inputSchema: {
+        type: 'object',
+        properties: {},
+        required: [],
+    },
+};
+export async function listWorkspaces(auth, _args) {
+    const results = await listWorkspacesQuery(auth, {
+        includeProjects: false,
+    });
+    const workspaces = results.workspaces || [];
+    if (workspaces.length === 0) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'No workspaces found.',
+                },
+            ],
+        };
+    }
+    // Format as clean summary
+    let output = `🏢 Your Workspaces (${workspaces.length} total)\n\n`;
+    workspaces.forEach((workspace, index) => {
+        output += `${index + 1}. **${workspace.name}**\n`;
+        output += `   ID: ${workspace.id}\n`;
+        output += `   Role: ${workspace.role}\n`;
+        output += `   Created: ${workspace.createdAt?.substring(0, 10) || 'Unknown'}\n`;
+        output += '\n';
+    });
+    output += `💡 Use list_projects with a workspace ID to see projects in a workspace.`;
+    return {
+        content: [
+            {
+                type: 'text',
+                text: output,
+            },
+        ],
+    };
+}
+//# sourceMappingURL=list-workspaces.js.map

package/dist/tools/list-workspaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-workspaces.js","sourceRoot":"","sources":["../../src/tools/list-workspaces.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,IAAI,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAExF,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,2GAA2G;IAC7G,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;KACb;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAiB,EAAE,KAAU;IAChE,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,IAAI,EAAE;QAC9C,eAAe,EAAE,KAAK;KACvB,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC;IAE5C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,sBAAsB;iBAC7B;aACF;SACF,CAAC;IACJ,CAAC;IAED,0BAA0B;IAC1B,IAAI,MAAM,GAAG,uBAAuB,UAAU,CAAC,MAAM,aAAa,CAAC;IAEnE,UAAU,CAAC,OAAO,CAAC,CAAC,SAAc,EAAE,KAAa,EAAE,EAAE;QACnD,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,OAAO,SAAS,CAAC,IAAI,MAAM,CAAC;QAClD,MAAM,IAAI,UAAU,SAAS,CAAC,EAAE,IAAI,CAAC;QACrC,MAAM,IAAI,YAAY,SAAS,CAAC,IAAI,IAAI,CAAC;QACzC,MAAM,IAAI,eAAe,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,SAAS,IAAI,CAAC;QAChF,MAAM,IAAI,IAAI,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,0EAA0E,CAAC;IAErF,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,MAAM;aACb;SACF;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,38 @@
+import type { AuthContext } from '../types.js';
+export declare const searchDocumentationTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            workspaceId: {
+                type: string;
+                description: string;
+            };
+            projectId: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            offset: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function searchDocumentation(auth: AuthContext, args: any): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=search-documentation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search-documentation.d.ts","sourceRoot":"","sources":["../../src/tools/search-documentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BnC,CAAC;AAEF,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG;;;;;GAuBrE"}

package/dist/tools/search-documentation.js

@@ -0,0 +1,53 @@
+import { searchDocumentation as searchQuery } from '../queries/search-queries.js';
+export const searchDocumentationTool = {
+    name: 'search_documentation',
+    description: 'Search through all documentation files you have access to. Returns matching files with highlighted excerpts. Use this to find relevant documentation across all your workspaces.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'The search query to find in file titles and content',
+            },
+            workspaceId: {
+                type: 'string',
+                description: 'Optional: filter results to a specific workspace',
+            },
+            projectId: {
+                type: 'string',
+                description: 'Optional: filter results to a specific project',
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum number of results to return (default: 10, max: 50)',
+            },
+            offset: {
+                type: 'number',
+                description: 'Number of results to skip for pagination (default: 0)',
+            },
+        },
+        required: ['query'],
+    },
+};
+export async function searchDocumentation(auth, args) {
+    const { query, workspaceId, projectId, limit, offset } = args;
+    if (!query || typeof query !== 'string') {
+        throw new Error('query parameter is required and must be a string');
+    }
+    const results = await searchQuery(auth, {
+        query,
+        workspaceId,
+        projectId,
+        limit,
+        offset,
+    });
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(results, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=search-documentation.js.map

package/dist/tools/search-documentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-documentation.js","sourceRoot":"","sources":["../../src/tools/search-documentation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,IAAI,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAElF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EACT,kLAAkL;IACpL,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qDAAqD;aACnE;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kDAAkD;aAChE;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gDAAgD;aAC9D;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4DAA4D;aAC1E;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uDAAuD;aACrE;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAiB,EAAE,IAAS;IACpE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAE9D,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE;QACtC,KAAK;QACL,WAAW;QACX,SAAS;QACT,KAAK;QACL,MAAM;KACP,CAAC,CAAC;IAEH,OAAO;QACL,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"}

package/dist/types.d.ts

@@ -0,0 +1,126 @@
+export interface JWTPayload {
+    userId: string;
+    email: string;
+    workspaceId?: string;
+}
+export interface AuthContext {
+    userId: string;
+    email: string;
+    workspaceId?: string | null;
+    sessionId?: string;
+}
+export interface UserWorkspace {
+    workspaceId: string;
+    role: 'owner' | 'admin' | 'editor' | 'viewer';
+}
+export interface SearchOptions {
+    query: string;
+    workspaceId?: string;
+    projectId?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface SearchResult {
+    fileId: string;
+    title: string;
+    path: string;
+    content: string;
+    projectId: string;
+    projectName: string;
+    workspaceId: string;
+    workspaceName: string;
+    matchScore: number;
+    updatedAt: Date;
+}
+export interface FileWithMetadata {
+    id: string;
+    title: string;
+    path: string;
+    content: string;
+    currentVersion: number;
+    status: string;
+    projectId: string;
+    projectName: string;
+    workspaceId: string;
+    workspaceName: string;
+    createdAt: Date;
+    updatedAt: Date;
+    createdBy: {
+        id: string;
+        name: string;
+        email: string;
+    };
+    updatedBy: {
+        id: string;
+        name: string;
+        email: string;
+    };
+}
+export interface FileListItem {
+    id: string;
+    title: string;
+    path: string;
+    currentVersion: number;
+    status: string;
+    projectId: string;
+    projectName: string;
+    updatedAt: Date;
+    preview: string;
+}
+export interface FileVersion {
+    versionNumber: number;
+    changeSummary: string | null;
+    createdAt: Date;
+    createdBy: {
+        id: string;
+        name: string;
+        email: string;
+    };
+    contentPreview: string;
+}
+export interface WorkspaceWithRole {
+    id: string;
+    name: string;
+    slug: string;
+    role: 'owner' | 'admin' | 'editor' | 'viewer';
+    projects?: ProjectInfo[];
+}
+export interface ProjectInfo {
+    id: string;
+    name: string;
+    slug: string;
+    description: string | null;
+    fileCount: number;
+}
+export interface ProjectStructure {
+    project: {
+        id: string;
+        name: string;
+        slug: string;
+        description: string | null;
+        workspaceId: string;
+        workspaceName: string;
+    };
+    structure: {
+        rootFiles: Array<{
+            id: string;
+            title: string;
+            path: string;
+        }>;
+        folders: Array<{
+            id: string;
+            name: string;
+            path: string;
+            files: Array<{
+                id: string;
+                title: string;
+                path: string;
+            }>;
+        }>;
+    };
+    stats: {
+        totalFiles: number;
+        totalFolders: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@doxhub/mcp-server",
+  "version": "0.1.0",
+  "description": "Model Context Protocol (MCP) server for DoxHub - Connect Claude to your documentation",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "ai",
+    "documentation",
+    "doxhub"
+  ],
+  "author": "DoxHub",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tomjutla/doxhub.git",
+    "directory": "packages/mcp-server"
+  },
+  "homepage": "https://doxhub.io/docs/mcp-integration",
+  "bugs": {
+    "url": "https://github.com/tomjutla/doxhub/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "doxhub-mcp-server": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "type-check": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^0.5.0",
+    "jsonwebtoken": "^9.0.2",
+    "dotenv": "^16.3.1",
+    "open": "^9.1.0",
+    "chalk": "^5.3.0"
+  },
+  "devDependencies": {
+    "@types/jsonwebtoken": "^9.0.5",
+    "@types/node": "^20.11.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}