mcp-lsp-driver 0.1.0 → 0.2.0

package/README.md

@@ -37,7 +37,9 @@ const fileAccess = {
     return await fs.readFile(uri, 'utf-8')
   },
 
-  getFileTree: (uri: string) => yourIDE.workspace.files
+  getFileTree: (uri: string) => yourIDE.workspace.getFileTree(uri),
+
+  readDirectory: (uri: string) => yourIDE.workspace.readDirectory(uri)
 }
 
 // 3. Implement User Interaction (required for edits)
@@ -109,6 +111,7 @@ Provides disk access for reading files:
 interface FileAccessProvider {
   readFile(uri: UnifiedUri): Promise<string>
   getFileTree(folderPath: UnifiedUri): Promise<string[]>
+  readDirectory(folderPath: UnifiedUri): Promise<string[]>
 }
 ```
 
@@ -320,9 +323,21 @@ Returns document symbols formatted as a hierarchical markdown outline, including
 
 No subscription support for this resource (read-only).
 
+### `lsp://filetree/{path}`
+
+Get the complete file tree for a directory, excluding git-ignored files.
+
+**Resource URI Pattern:** `lsp://filetree/{+path}`
+
+**Example:** `lsp://filetree/src`, `lsp://filetree/.`
+
+Returns a JSON array of all file paths in the directory tree (recursive). Use "." for the root directory.
+
+No subscription support for this resource (read-only).
+
 ### `lsp://files/{path}`
 
-For directories: gets the file tree for a directory, excluding git-ignored files. For files: gets file content with optional line range.
+For directories: returns directory children (git-ignored files excluded, similar to `ls`). For files: gets file content with optional line range.
 
 **Resource URI Pattern:** `lsp://files/{+path}`
 

package/dist/formatting.js

@@ -10,6 +10,9 @@ export const makeToolResult = (result) => ({
  * Normalizes a URI to handle Windows/Unix path separator differences.
  */
 export function normalizeUri(uri) {
+    if (uri.includes('..')) {
+        throw new Error('URI could not include ".." operator');
+    }
     // If it's already a file:// URI, leave it alone
     if (uri.startsWith('file://')) {
         return uri;

package/dist/interfaces.d.ts

@@ -20,13 +20,19 @@ export interface FileAccessProvider {
      * @throws Error if the file cannot be read
      */
     readFile(uri: UnifiedUri): Promise<string>;
+    /**
+     * Read children in a directory, exluding git-ignored files, similar to Unix `ls` command
+     * @param relativePath - The path to the folder to read
+     * @returns Array of file/folder paths in the directory
+     */
+    readDirectory(relativePath: UnifiedUri): Promise<string[]>;
     /**
      * Gets the file tree for a directory, excluding git-ignored files.
      *
-     * @param folderPath - The path to the folder to read
+     * @param relativePath - The path to the folder to read
      * @returns Array of file/folder paths in the directory tree
      */
-    getFileTree(folderPath: UnifiedUri): Promise<string[]>;
+    getFileTree?: (relativePath: UnifiedUri) => Promise<string[]>;
 }
 /**
  * Provides user interaction capabilities for edit operations.

package/dist/server.js

@@ -465,12 +465,28 @@ function registerApplyEditTool(server, capabilities, resolver) {
  * - lsp://files/path/to/file.ext#L21-L28 - read line range
  */
 function registerFilesystemResource(server, capabilities) {
-    const fileAccessProvider = capabilities.fileAccess;
+    const { readFile, readDirectory, getFileTree } = capabilities.fileAccess;
+    if (getFileTree !== undefined) {
+        const fileTreeTemplate = new ResourceTemplate('lsp://filetree/{+path}', {
+            list: undefined,
+        });
+        server.registerResource('fileTree', fileTreeTemplate, {
+            description: 'Access file tree inside a relative path or use "." for root.',
+        }, async (uri, { path }) => ({
+            contents: [
+                {
+                    uri: uri.toString(),
+                    mimeType: 'application/json',
+                    text: JSON.stringify((await getFileTree(normalizeUri(path))) ?? ''),
+                },
+            ],
+        }));
+    }
     const filesystemTemplate = new ResourceTemplate('lsp://files/{+path}', {
         list: undefined, // Cannot enumerate all directories
     });
     server.registerResource('filesystem', filesystemTemplate, {
-        description: 'Access filesystem resources. For directories: returns file tree (git-ignored files excluded). ' +
+        description: 'Access filesystem resources. For directories: returns children (git-ignored files excluded). ' +
             'For files: returns file content. Supports line ranges with #L23 or #L23-L30 fragment.',
     }, async (uri, variables) => {
         const uriString = uri.toString();
@@ -488,7 +504,7 @@ function registerFilesystemResource(server, capabilities) {
             const lineRange = parseLineRange(fragment);
             // Try reading as a file first
             try {
-                const content = await fileAccessProvider.readFile(normalizedPath);
+                const content = await readFile(normalizedPath);
                 // If we have a line range, extract those lines
                 const resultContent = lineRange
                     ? extractLines(content, lineRange)
@@ -505,7 +521,7 @@ function registerFilesystemResource(server, capabilities) {
             }
             catch {
                 // File reading failed, try as directory
-                const files = await fileAccessProvider.getFileTree(normalizedPath);
+                const files = await readDirectory(normalizedPath);
                 return {
                     contents: [
                         {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-lsp-driver",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "MCP LSP Driver for IDE plugins to easily expose LSP features via an MCP server.",
   "type": "module",
   "main": "dist/index.js",