mcp-docs-service 0.2.0 → 0.2.1

package/dist/handlers/file.js

@@ -0,0 +1,222 @@
+import fs from "fs/promises";
+import path from "path";
+import { validatePath } from "../utils/path.js";
+import { getFileStats, searchFiles, applyFileEdits } from "../utils/file.js";
+/**
+ * Reads a file and returns its content
+ */
+export async function readFile(filePath, allowedDirectories) {
+    try {
+        const normalizedPath = await validatePath(filePath, allowedDirectories);
+        const content = await fs.readFile(normalizedPath, "utf-8");
+        return {
+            content: [{ type: "text", text: "File read successfully" }],
+            metadata: {
+                path: filePath,
+                content,
+            },
+        };
+    }
+    catch (error) {
+        return {
+            content: [{ type: "text", text: `Error reading file: ${error.message}` }],
+            isError: true,
+        };
+    }
+}
+/**
+ * Writes content to a file
+ */
+export async function writeFile(filePath, content, allowedDirectories) {
+    try {
+        const normalizedPath = await validatePath(filePath, allowedDirectories);
+        // Ensure the directory exists
+        const dirPath = path.dirname(normalizedPath);
+        await fs.mkdir(dirPath, { recursive: true });
+        // Write the file
+        await fs.writeFile(normalizedPath, content);
+        return {
+            content: [{ type: "text", text: "File written successfully" }],
+            metadata: {
+                path: filePath,
+            },
+        };
+    }
+    catch (error) {
+        return {
+            content: [{ type: "text", text: `Error writing file: ${error.message}` }],
+            isError: true,
+        };
+    }
+}
+/**
+ * Lists files in a directory
+ */
+export async function listFiles(dirPath, allowedDirectories) {
+    try {
+        const normalizedPath = await validatePath(dirPath, allowedDirectories);
+        const entries = await fs.readdir(normalizedPath, { withFileTypes: true });
+        const files = entries.map((entry) => ({
+            name: entry.name,
+            isDirectory: entry.isDirectory(),
+            isFile: entry.isFile(),
+        }));
+        return {
+            content: [
+                { type: "text", text: `Listed ${files.length} files in ${dirPath}` },
+            ],
+            metadata: {
+                path: dirPath,
+                files,
+            },
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                { type: "text", text: `Error listing files: ${error.message}` },
+            ],
+            isError: true,
+        };
+    }
+}
+/**
+ * Gets information about a file
+ */
+export async function getFileInfo(filePath, allowedDirectories) {
+    try {
+        const normalizedPath = await validatePath(filePath, allowedDirectories);
+        const fileInfo = await getFileStats(normalizedPath);
+        return {
+            content: [
+                { type: "text", text: "File information retrieved successfully" },
+            ],
+            metadata: {
+                path: filePath,
+                info: fileInfo,
+            },
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                { type: "text", text: `Error getting file info: ${error.message}` },
+            ],
+            isError: true,
+        };
+    }
+}
+/**
+ * Searches for files matching a pattern
+ */
+export async function searchForFiles(rootPath, pattern, excludePatterns = [], allowedDirectories) {
+    try {
+        const normalizedPath = await validatePath(rootPath, allowedDirectories);
+        const files = await searchFiles(normalizedPath, pattern, excludePatterns);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Found ${files.length} files matching pattern "${pattern}"`,
+                },
+            ],
+            metadata: {
+                rootPath,
+                pattern,
+                excludePatterns,
+                files,
+            },
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                { type: "text", text: `Error searching files: ${error.message}` },
+            ],
+            isError: true,
+        };
+    }
+}
+/**
+ * Applies edits to a file
+ */
+export async function editFile(filePath, edits, allowedDirectories) {
+    try {
+        const normalizedPath = await validatePath(filePath, allowedDirectories);
+        const diff = await applyFileEdits(normalizedPath, edits, false);
+        return {
+            content: [{ type: "text", text: "File edited successfully" }],
+            metadata: {
+                path: filePath,
+                diff,
+            },
+        };
+    }
+    catch (error) {
+        return {
+            content: [{ type: "text", text: `Error editing file: ${error.message}` }],
+            isError: true,
+        };
+    }
+}
+/**
+ * Gets the directory structure as a tree
+ */
+export async function getDirectoryTree(dirPath, allowedDirectories) {
+    try {
+        const normalizedPath = await validatePath(dirPath, allowedDirectories);
+        async function buildTree(currentPath) {
+            const entries = await fs.readdir(currentPath, { withFileTypes: true });
+            const result = [];
+            for (const entry of entries) {
+                const entryPath = path.join(currentPath, entry.name);
+                if (entry.isDirectory()) {
+                    const children = await buildTree(entryPath);
+                    result.push({
+                        name: entry.name,
+                        path: entryPath,
+                        type: "directory",
+                        children,
+                    });
+                }
+                else {
+                    result.push({
+                        name: entry.name,
+                        path: entryPath,
+                        type: "file",
+                    });
+                }
+            }
+            // Sort entries: directories first, then files, both alphabetically
+            result.sort((a, b) => {
+                if (a.type !== b.type) {
+                    return a.type === "directory" ? -1 : 1;
+                }
+                return a.name.localeCompare(b.name);
+            });
+            return result;
+        }
+        const tree = await buildTree(normalizedPath);
+        return {
+            content: [
+                { type: "text", text: "Directory tree retrieved successfully" },
+            ],
+            metadata: {
+                path: dirPath,
+                tree,
+            },
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error getting directory tree: ${error.message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=file.js.map

package/dist/handlers/file.js.map

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

package/dist/handlers/index.d.ts

@@ -0,0 +1 @@
+export * from "./docs.js";

package/dist/handlers/index.js

@@ -0,0 +1,3 @@
+// Re-export all handlers
+export * from "./docs.js";
+//# sourceMappingURL=index.js.map

package/dist/handlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/handlers/index.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,cAAc,WAAW,CAAC"}

package/dist/index.d.ts

@@ -1,24 +1,2 @@
-/**
- * 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;
+#!/usr/bin/env node
+export {};