mcp-docs-service 0.1.0

package/dist/core/mcpDocsServer.js

@@ -0,0 +1,395 @@
+"use strict";
+/**
+ * MCP Documentation Management Server
+ * This server implements the Model Context Protocol for managing documentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCPDocsServer = void 0;
+const docManager_js_1 = require("./docManager.js");
+const docAnalyzer_js_1 = require("./docAnalyzer.js");
+class MCPDocsServer {
+    constructor(docsDir = "./docs", options = {}) {
+        this.docManager = new docManager_js_1.DocManager(docsDir, options);
+        this.docAnalyzer = new docAnalyzer_js_1.DocAnalyzer(this.docManager);
+        // Log initialization info
+        console.error(`MCP Documentation Service initialized with docs directory: ${docsDir}`);
+        if (options.createIfNotExists) {
+            console.error("Directory will be created if it doesn't exist");
+        }
+    }
+    /**
+     * Execute a query using the MCP protocol
+     */
+    async executeQuery(sql) {
+        try {
+            // Parse the SQL-like query to extract command and parameters
+            const { command, params } = this.parseQuery(sql);
+            // Execute the appropriate command
+            switch (command) {
+                case "list_files":
+                    return await this.listFiles(params);
+                case "list_directories":
+                    return await this.listDirectories(params);
+                case "get_document":
+                    return await this.getDocument(params);
+                case "search_documents":
+                    return await this.searchDocuments(params);
+                case "create_document":
+                    return await this.createDocument(params);
+                case "update_document":
+                    return await this.updateDocument(params);
+                case "delete_document":
+                    return await this.deleteDocument(params);
+                case "analyze_docs":
+                    return await this.analyzeDocumentation(params);
+                case "get_health_score":
+                    return await this.getHealthScore();
+                case "get_suggestions":
+                    return await this.getSuggestions();
+                default:
+                    return {
+                        success: false,
+                        error: `Unknown command: ${command}`,
+                    };
+            }
+        }
+        catch (error) {
+            console.error("Error executing query:", error);
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    /**
+     * Parse a query string into command and parameters
+     */
+    parseQuery(query) {
+        // Default to empty parameters
+        const params = {};
+        // Handle simple command syntax
+        if (query.indexOf("(") === -1) {
+            return { command: query.trim(), params };
+        }
+        // Extract command name
+        const commandMatch = query.match(/^\s*(\w+)\s*\(/);
+        if (!commandMatch) {
+            throw new Error(`Invalid query format: ${query}`);
+        }
+        const command = commandMatch[1];
+        // Extract parameters between parentheses
+        const paramsMatch = query.match(/\(\s*(.*)\s*\)/s);
+        if (!paramsMatch) {
+            return { command, params };
+        }
+        // Parse parameter string
+        const paramsStr = paramsMatch[1];
+        // Handle JSON object parameters
+        if (paramsStr.trim().startsWith("{") && paramsStr.trim().endsWith("}")) {
+            try {
+                return { command, params: JSON.parse(paramsStr) };
+            }
+            catch (e) {
+                throw new Error(`Invalid JSON parameters: ${e instanceof Error ? e.message : String(e)}`);
+            }
+        }
+        // Parse key=value parameters
+        let currentKey = "";
+        let currentValue = "";
+        let inQuotes = false;
+        let inObject = false;
+        let inArray = false;
+        let objectDepth = 0;
+        let arrayDepth = 0;
+        for (let i = 0; i < paramsStr.length; i++) {
+            const char = paramsStr[i];
+            const nextChar = paramsStr[i + 1] || "";
+            // Handle quotes
+            if (char === '"' && paramsStr[i - 1] !== "\\") {
+                inQuotes = !inQuotes;
+                currentValue += char;
+                continue;
+            }
+            // Handle objects
+            if (char === "{" && !inQuotes) {
+                inObject = true;
+                objectDepth++;
+                currentValue += char;
+                continue;
+            }
+            if (char === "}" && !inQuotes) {
+                objectDepth--;
+                if (objectDepth === 0)
+                    inObject = false;
+                currentValue += char;
+                continue;
+            }
+            // Handle arrays
+            if (char === "[" && !inQuotes) {
+                inArray = true;
+                arrayDepth++;
+                currentValue += char;
+                continue;
+            }
+            if (char === "]" && !inQuotes) {
+                arrayDepth--;
+                if (arrayDepth === 0)
+                    inArray = false;
+                currentValue += char;
+                continue;
+            }
+            // Handle key=value separator
+            if (char === "=" &&
+                !inQuotes &&
+                !inObject &&
+                !inArray &&
+                currentKey === "") {
+                currentKey = currentValue.trim();
+                currentValue = "";
+                continue;
+            }
+            // Handle parameter separator
+            if (char === "," && !inQuotes && !inObject && !inArray) {
+                if (currentKey && currentValue) {
+                    // Try to parse the value
+                    try {
+                        if (currentValue.startsWith('"') && currentValue.endsWith('"')) {
+                            // String value
+                            params[currentKey] = JSON.parse(currentValue);
+                        }
+                        else if (currentValue.toLowerCase() === "true" ||
+                            currentValue.toLowerCase() === "false") {
+                            // Boolean value
+                            params[currentKey] = currentValue.toLowerCase() === "true";
+                        }
+                        else if (!isNaN(Number(currentValue))) {
+                            // Number value
+                            params[currentKey] = Number(currentValue);
+                        }
+                        else if (currentValue.startsWith("[") &&
+                            currentValue.endsWith("]")) {
+                            // Array value
+                            params[currentKey] = JSON.parse(currentValue);
+                        }
+                        else if (currentValue.startsWith("{") &&
+                            currentValue.endsWith("}")) {
+                            // Object value
+                            params[currentKey] = JSON.parse(currentValue);
+                        }
+                        else {
+                            // Everything else as string
+                            params[currentKey] = currentValue;
+                        }
+                    }
+                    catch (e) {
+                        // If parsing fails, use as string
+                        params[currentKey] = currentValue;
+                    }
+                }
+                currentKey = "";
+                currentValue = "";
+                continue;
+            }
+            // Add character to current value
+            currentValue += char;
+        }
+        // Handle the last parameter
+        if (currentKey && currentValue) {
+            try {
+                if (currentValue.startsWith('"') && currentValue.endsWith('"')) {
+                    // String value
+                    params[currentKey] = JSON.parse(currentValue);
+                }
+                else if (currentValue.toLowerCase() === "true" ||
+                    currentValue.toLowerCase() === "false") {
+                    // Boolean value
+                    params[currentKey] = currentValue.toLowerCase() === "true";
+                }
+                else if (!isNaN(Number(currentValue))) {
+                    // Number value
+                    params[currentKey] = Number(currentValue);
+                }
+                else if (currentValue.startsWith("[") && currentValue.endsWith("]")) {
+                    // Array value
+                    params[currentKey] = JSON.parse(currentValue);
+                }
+                else if (currentValue.startsWith("{") && currentValue.endsWith("}")) {
+                    // Object value
+                    params[currentKey] = JSON.parse(currentValue);
+                }
+                else {
+                    // Everything else as string
+                    params[currentKey] = currentValue;
+                }
+            }
+            catch (e) {
+                // If parsing fails, use as string
+                params[currentKey] = currentValue;
+            }
+        }
+        return { command, params };
+    }
+    /**
+     * List all markdown files
+     */
+    async listFiles(params) {
+        const directory = params.directory || "";
+        const files = await this.docManager.listMarkdownFiles(directory);
+        return {
+            success: true,
+            data: files,
+        };
+    }
+    /**
+     * List all directories
+     */
+    async listDirectories(params) {
+        const directory = params.directory || "";
+        const directories = await this.docManager.listDirectories(directory);
+        return {
+            success: true,
+            data: directories,
+        };
+    }
+    /**
+     * Get a document by path
+     */
+    async getDocument(params) {
+        if (!params.path) {
+            return {
+                success: false,
+                error: "Document path is required",
+            };
+        }
+        const document = await this.docManager.getDocument(params.path);
+        if (!document) {
+            return {
+                success: false,
+                error: `Document not found: ${params.path}`,
+            };
+        }
+        return {
+            success: true,
+            data: document,
+        };
+    }
+    /**
+     * Search for documents
+     */
+    async searchDocuments(params) {
+        const options = {
+            query: params.query || "",
+            tags: params.tags,
+            status: params.status,
+            directory: params.directory,
+        };
+        const results = await this.docManager.searchDocuments(options);
+        return {
+            success: true,
+            data: results,
+        };
+    }
+    /**
+     * Create a new document
+     */
+    async createDocument(params) {
+        if (!params.path) {
+            return {
+                success: false,
+                error: "Document path is required",
+            };
+        }
+        if (!params.content) {
+            return {
+                success: false,
+                error: "Document content is required",
+            };
+        }
+        if (!params.metadata || typeof params.metadata !== "object") {
+            return {
+                success: false,
+                error: "Document metadata is required",
+            };
+        }
+        const createParams = {
+            path: params.path,
+            content: params.content,
+            metadata: params.metadata,
+        };
+        const success = await this.docManager.createDocument(createParams);
+        return {
+            success,
+            data: { created: success },
+        };
+    }
+    /**
+     * Update an existing document
+     */
+    async updateDocument(params) {
+        if (!params.path) {
+            return {
+                success: false,
+                error: "Document path is required",
+            };
+        }
+        const updateParams = {
+            path: params.path,
+            content: params.content,
+            metadata: params.metadata,
+        };
+        const success = await this.docManager.updateDocument(updateParams);
+        return {
+            success,
+            data: { updated: success },
+        };
+    }
+    /**
+     * Delete a document
+     */
+    async deleteDocument(params) {
+        if (!params.path) {
+            return {
+                success: false,
+                error: "Document path is required",
+            };
+        }
+        const success = await this.docManager.deleteDocument(params.path);
+        return {
+            success,
+            data: { deleted: success },
+        };
+    }
+    /**
+     * Analyze documentation
+     */
+    async analyzeDocumentation(params) {
+        const directory = params.directory;
+        const analysis = await this.docAnalyzer.analyzeDocumentation(directory);
+        return {
+            success: true,
+            data: analysis,
+        };
+    }
+    /**
+     * Get documentation health score
+     */
+    async getHealthScore() {
+        const score = await this.docAnalyzer.calculateHealthScore();
+        return {
+            success: true,
+            data: { score },
+        };
+    }
+    /**
+     * Get suggestions for improving documentation
+     */
+    async getSuggestions() {
+        const suggestions = await this.docAnalyzer.generateSuggestions();
+        return {
+            success: true,
+            data: { suggestions },
+        };
+    }
+}
+exports.MCPDocsServer = MCPDocsServer;
+//# sourceMappingURL=mcpDocsServer.js.map

package/dist/core/mcpDocsServer.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * MCP Documentation Management Service
+ * Main entry point for the package
+ */
+export * from "./core/docManager.js";
+export * from "./core/docProcessor.js";
+export * from "./core/docAnalyzer.js";
+export * from "./core/mcpDocsServer.js";
+export * from "./types/index.js";
+export * from "./utils/index.js";
+import { MCPDocsServer } from "./core/mcpDocsServer.js";
+/**
+ * MCP Query function that can be registered with Cursor's MCP system
+ * @param sql - The SQL-like query to execute
+ * @param options - Options for the MCP server
+ * @returns The query result
+ */
+export declare function query(sql: string, options?: {
+    docsDir?: string;
+    createIfNotExists?: boolean;
+    fileExtensions?: string[];
+}): Promise<import("./types/index.js").MCPQueryResult>;
+declare const mcpDocsServer: MCPDocsServer;
+export default mcpDocsServer;

package/dist/index.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * MCP Documentation Management Service
+ * Main entry point for the package
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.query = void 0;
+// Export core functionality
+__exportStar(require("./core/docManager.js"), exports);
+__exportStar(require("./core/docProcessor.js"), exports);
+__exportStar(require("./core/docAnalyzer.js"), exports);
+__exportStar(require("./core/mcpDocsServer.js"), exports);
+// Export types
+__exportStar(require("./types/index.js"), exports);
+// Export utility functions
+__exportStar(require("./utils/index.js"), exports);
+// Import core components
+const mcpDocsServer_js_1 = require("./core/mcpDocsServer.js");
+/**
+ * MCP Query function that can be registered with Cursor's MCP system
+ * @param sql - The SQL-like query to execute
+ * @param options - Options for the MCP server
+ * @returns The query result
+ */
+async function query(sql, options = {}) {
+    // Create a server instance with the specified options
+    const server = new mcpDocsServer_js_1.MCPDocsServer(options.docsDir || "./docs", {
+        createIfNotExists: options.createIfNotExists,
+        fileExtensions: options.fileExtensions,
+    });
+    // Execute the query
+    return await server.executeQuery(sql);
+}
+exports.query = query;
+// Create and export singleton instance with default options
+const mcpDocsServer = new mcpDocsServer_js_1.MCPDocsServer("./docs", { createIfNotExists: true });
+exports.default = mcpDocsServer;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;AAEH,4BAA4B;AAC5B,uDAAqC;AACrC,yDAAuC;AACvC,wDAAsC;AACtC,0DAAwC;AAExC,eAAe;AACf,mDAAiC;AAEjC,2BAA2B;AAC3B,mDAAiC;AAEjC,yBAAyB;AACzB,8DAAwD;AAExD;;;;;GAKG;AACI,KAAK,UAAU,KAAK,CACzB,GAAW,EACX,UAII,EAAE;IAEN,sDAAsD;IACtD,MAAM,MAAM,GAAG,IAAI,gCAAa,CAAC,OAAO,CAAC,OAAO,IAAI,QAAQ,EAAE;QAC5D,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;QAC5C,cAAc,EAAE,OAAO,CAAC,cAAc;KACvC,CAAC,CAAC;IAEH,oBAAoB;IACpB,OAAO,MAAM,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;AACxC,CAAC;AAhBD,sBAgBC;AAED,4DAA4D;AAC5D,MAAM,aAAa,GAAG,IAAI,gCAAa,CAAC,QAAQ,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC;AAC/E,kBAAe,aAAa,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Types for the MCP Documentation Management Service
+ */
+export interface DocMetadata {
+    title: string;
+    description?: string;
+    tags?: string[];
+    lastUpdated?: string;
+    status?: "draft" | "review" | "published";
+    globs?: string[];
+    alwaysApply?: boolean;
+}
+export interface DocContent {
+    metadata: DocMetadata;
+    content: string;
+    path: string;
+}
+export interface SearchOptions {
+    query: string;
+    tags?: string[];
+    status?: "draft" | "review" | "published";
+    directory?: string;
+}
+export interface DocUpdateParams {
+    path: string;
+    content?: string;
+    metadata?: Partial<DocMetadata>;
+}
+export interface DocCreateParams {
+    path: string;
+    content: string;
+    metadata: DocMetadata;
+}
+export interface MCPQueryResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+export interface DocSummary {
+    title: string;
+    description?: string;
+    path: string;
+    lastUpdated?: string;
+    tags?: string[];
+    status?: "draft" | "review" | "published";
+}
+export interface DocAnalysisResult {
+    documentCount: number;
+    byStatus?: Record<string, number>;
+    byDirectory?: Record<string, number>;
+    recentlyUpdated?: DocSummary[];
+    missingDescriptions?: DocSummary[];
+}

package/dist/types/index.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Types for the MCP Documentation Management Service
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Utility functions for the MCP Documentation Service
+ */
+/**
+ * Check if a path is valid
+ * @param path - Path to check
+ * @returns True if the path is valid, false otherwise
+ */
+export declare function isValidPath(path: string): boolean;
+/**
+ * Normalize a path
+ * @param path - Path to normalize
+ * @returns Normalized path
+ */
+export declare function normalizePath(path: string): string;
+/**
+ * Get file extension
+ * @param path - Path to get extension from
+ * @returns File extension
+ */
+export declare function getFileExtension(path: string): string;
+/**
+ * Get file name
+ * @param path - Path to get name from
+ * @returns File name
+ */
+export declare function getFileName(path: string): string;
+/**
+ * Get directory name
+ * @param path - Path to get directory name from
+ * @returns Directory name
+ */
+export declare function getDirectoryName(path: string): string;
+/**
+ * Join paths
+ * @param paths - Paths to join
+ * @returns Joined path
+ */
+export declare function joinPaths(...paths: string[]): string;
+/**
+ * Escape regex special characters
+ * @param str - String to escape
+ * @returns Escaped string
+ */
+export declare function escapeRegex(str: string): string;
+/**
+ * Calculate relevance score
+ * @param text - Text to search in
+ * @param query - Query to search for
+ * @returns Relevance score (0-1)
+ */
+export declare function calculateRelevance(text: string, query: string): number;
+/**
+ * Generate excerpt
+ * @param text - Text to generate excerpt from
+ * @param query - Query to highlight
+ * @param length - Excerpt length
+ * @returns Excerpt
+ */
+export declare function generateExcerpt(text: string, query: string, length?: number): string;