mcp-lsp-driver 0.0.1 → 0.1.0

package/README.md

@@ -35,7 +35,9 @@ const server = new McpServer({
 const fileAccess = {
   readFile: async (uri: string) => {
     return await fs.readFile(uri, 'utf-8')
-  }
+  },
+
+  getFileTree: (uri: string) => yourIDE.workspace.files
 }
 
 // 3. Implement User Interaction (required for edits)
@@ -72,13 +74,6 @@ const outline = {
   }
 }
 
-const filesystem = {
-  getFileTree: async (folderPath) => {
-    // Get file tree excluding git-ignored files
-    return await yourIDE.getFileTree(folderPath)
-  }
-}
-
 // 5. Register LSP tools and resources on the server
 const capabilities: IdeCapabilities = {
   fileAccess,
@@ -110,8 +105,10 @@ await server.connect(transport)
 Provides disk access for reading files:
 
 ```typescript
+// type UnifiedUri = string
 interface FileAccessProvider {
   readFile(uri: UnifiedUri): Promise<string>
+  getFileTree(folderPath: UnifiedUri): Promise<string[]>
 }
 ```
 
@@ -174,16 +171,6 @@ interface OutlineProvider {
 }
 ```
 
-#### `FilesystemProvider`
-
-```typescript
-interface FilesystemProvider {
-  getFileTree(folderPath: string): Promise<string[]>
-}
-```
-
-Provides filesystem access with git-ignore support. Returns file/folder paths in a directory tree, excluding git-ignored files.
-
 #### `GlobalFindProvider`
 
 ```typescript
@@ -218,7 +205,6 @@ interface IdeCapabilities {
   hierarchy?: HierarchyProvider             // Enables call_hierarchy tool
   diagnostics?: DiagnosticsProvider         // Enables diagnostics resources
   outline?: OutlineProvider                 // Enables outline resource
-  filesystem?: FilesystemProvider           // Enables filesystem resource
   globalFind?: GlobalFindProvider           // Enables global_find and global_replace tools
   onDiagnosticsChanged?: (callback: OnDiagnosticsChangedCallback) => void
 }
@@ -299,7 +285,7 @@ The SDK automatically registers resources based on which capabilities you provid
 
 Get diagnostics (errors, warnings) for a specific file.
 
-**Resource URI Pattern:** `lsp://diagnostics/{path}`
+**Resource URI Pattern:** `lsp://diagnostics/{+path}`
 
 **Example:** `lsp://diagnostics/src/main.ts`
 
@@ -323,7 +309,7 @@ Returns workspace diagnostics grouped by file, formatted as markdown.
 
 Get the document outline (symbol tree) for a file.
 
-**Resource URI Pattern:** `lsp://outline/{path}`
+**Resource URI Pattern:** `lsp://outline/{+path}`
 
 **Example:** `lsp://outline/src/components/Button.tsx`
 
@@ -336,13 +322,11 @@ No subscription support for this resource (read-only).
 
 ### `lsp://files/{path}`
 
-Get the file tree for a directory, excluding git-ignored files.
-
-**Resource URI Pattern:** `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.
 
-**Example:** `lsp://files/src`
+**Resource URI Pattern:** `lsp://files/{+path}`
 
-Returns a list of file/folder paths in the directory tree, formatted as markdown. Git-ignored files and directories are automatically excluded from the results.
+**Example:** `lsp://files/src`, `lsp://files/src/index.ts`, `lsp://files/src/index.ts#L1-L2`
 
 No subscription support for this resource (read-only).
 

package/dist/capabilities.d.ts

@@ -80,18 +80,6 @@ export interface OutlineProvider {
      */
     provideDocumentSymbols(uri: UnifiedUri): Promise<DocumentSymbol[]>;
 }
-/**
- * Provides filesystem access with git-ignore support.
- */
-export interface FilesystemProvider {
-    /**
-     * Gets the file tree for a directory, excluding git-ignored files.
-     *
-     * @param folderPath - The path to the folder to read
-     * @returns Array of file/folder paths in the directory tree
-     */
-    getFileTree(folderPath: string): Promise<string[]>;
-}
 /**
  * Search options for global find operations.
  */
@@ -165,8 +153,6 @@ export interface IdeCapabilities {
     diagnostics?: DiagnosticsProvider;
     /** Optional: Provides document outline (symbols) for files */
     outline?: OutlineProvider;
-    /** Optional: Provides filesystem access with git-ignore support */
-    filesystem?: FilesystemProvider;
     /** Optional: Provides global find and replace functionality */
     globalFind?: GlobalFindProvider;
     /**

package/dist/index.d.ts

@@ -6,7 +6,7 @@
  *
  * @packageDocumentation
  */
-export type { DefinitionProvider, DiagnosticsProvider, FilesystemProvider, GlobalFindMatch, GlobalFindOptions, GlobalFindProvider, HierarchyProvider, IdeCapabilities, OnDiagnosticsChangedCallback, OutlineProvider, ReferencesProvider, } from './capabilities.js';
+export type { DefinitionProvider, DiagnosticsProvider, GlobalFindMatch, GlobalFindOptions, GlobalFindProvider, HierarchyProvider, IdeCapabilities, OnDiagnosticsChangedCallback, OutlineProvider, ReferencesProvider, } from './capabilities.js';
 export type { FileAccessProvider, UserInteractionProvider, } from './interfaces.js';
 export type { ResolverConfig } from './resolver.js';
 export { SymbolResolutionError, SymbolResolver } from './resolver.js';

package/dist/interfaces.d.ts

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

package/dist/server.js

@@ -7,6 +7,36 @@
 import { ResourceTemplate, } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
 import { formatDiagnosticsAsMarkdown, formatSymbolsAsMarkdown, generateEditId, makeToolResult, normalizeUri, } from './formatting.js';
+/**
+ * Parses a line range fragment from a URI (e.g., "#L21" or "#L21-L28").
+ * @returns null if no valid line range, or { start, end } with 1-based line numbers
+ */
+function parseLineRange(fragment) {
+    if (!fragment)
+        return null;
+    // Match #Lxx or #Lxx-Lyy
+    const match = fragment.match(/^L(\d+)(?:-L(\d+))?$/);
+    if (!match || !match[1])
+        return null;
+    const start = parseInt(match[1], 10);
+    const end = match[2] ? parseInt(match[2], 10) : start;
+    if (start < 1 || end < start)
+        return null;
+    return { start, end };
+}
+/**
+ * Extracts lines from content based on a line range.
+ * @param content - The full file content
+ * @param range - 1-based line range { start, end }
+ * @returns The extracted lines as a string
+ */
+function extractLines(content, range) {
+    const lines = content.split(/\r?\n/);
+    // Convert to 0-based index
+    const startIdx = range.start - 1;
+    const endIdx = range.end;
+    return lines.slice(startIdx, endIdx).join('\n');
+}
 import { SymbolResolutionError, SymbolResolver, } from './resolver.js';
 import { ApplyEditSchema, CallHierarchySchema, FuzzyPositionSchema, GlobalFindSchema, GlobalReplaceSchema, } from './schemas.js';
 /**
@@ -57,15 +87,13 @@ function registerTools(server, capabilities, resolver) {
     }
 }
 function registerResources(server, capabilities) {
+    registerFilesystemResource(server, capabilities);
     if (capabilities.diagnostics) {
         registerDiagnosticsResources(server, capabilities);
     }
     if (capabilities.outline) {
         registerOutlineResource(server, capabilities);
     }
-    if (capabilities.filesystem) {
-        registerFilesystemResource(server, capabilities);
-    }
 }
 /**
  * Registers the goto_definition tool.
@@ -431,43 +459,71 @@ function registerApplyEditTool(server, capabilities, resolver) {
 }
 /**
  * Registers the filesystem resource.
- * - lsp://files/{path} - file tree for a directory (git-ignored files excluded)
+ * - lsp://files/path - file tree for a directory (git-ignored files excluded)
+ * - lsp://files/path/to/file.ext - read file content
+ * - lsp://files/path/to/file.ext#L21 - read specific line
+ * - lsp://files/path/to/file.ext#L21-L28 - read line range
  */
 function registerFilesystemResource(server, capabilities) {
-    const filesystemProvider = capabilities.filesystem;
-    if (!filesystemProvider)
-        return;
+    const fileAccessProvider = capabilities.fileAccess;
     const filesystemTemplate = new ResourceTemplate('lsp://files/{+path}', {
         list: undefined, // Cannot enumerate all directories
     });
     server.registerResource('filesystem', filesystemTemplate, {
-        description: 'File tree for a directory, excluding git-ignored files. Use the folder path after lsp://files/',
-        mimeType: 'text/markdown',
-    }, async (_uri, variables) => {
+        description: 'Access filesystem resources. For directories: returns file tree (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();
         try {
-            const path = variables.path;
+            const pathWithFragment = variables.path;
+            // Parse fragment for line range (e.g., #L23 or #L23-L30)
+            let fragment;
+            let path = pathWithFragment;
+            const hashIndex = pathWithFragment.indexOf('#');
+            if (hashIndex !== -1) {
+                fragment = pathWithFragment.slice(hashIndex + 1);
+                path = pathWithFragment.slice(0, hashIndex);
+            }
             const normalizedPath = normalizeUri(path);
-            const files = await filesystemProvider.getFileTree(normalizedPath);
-            const markdown = files.length === 0
-                ? 'No files found in directory.'
-                : files.map((f) => `- ${f}`).join('\n');
-            return {
-                contents: [
-                    {
-                        uri: `lsp://files/${path}`,
-                        mimeType: 'text/markdown',
-                        text: markdown,
-                    },
-                ],
-            };
+            const lineRange = parseLineRange(fragment);
+            // Try reading as a file first
+            try {
+                const content = await fileAccessProvider.readFile(normalizedPath);
+                // If we have a line range, extract those lines
+                const resultContent = lineRange
+                    ? extractLines(content, lineRange)
+                    : content;
+                return {
+                    contents: [
+                        {
+                            uri: uriString,
+                            mimeType: 'text/plain',
+                            text: resultContent,
+                        },
+                    ],
+                };
+            }
+            catch {
+                // File reading failed, try as directory
+                const files = await fileAccessProvider.getFileTree(normalizedPath);
+                return {
+                    contents: [
+                        {
+                            uri: uriString,
+                            mimeType: 'application/json',
+                            text: JSON.stringify(files),
+                        },
+                    ],
+                };
+            }
         }
         catch (error) {
             const message = `Error: ${error instanceof Error ? error.message : String(error)}`;
             return {
                 contents: [
                     {
-                        uri: `lsp://files/${variables.path}`,
-                        mimeType: 'text/markdown',
+                        uri: uriString,
+                        mimeType: 'text/plain',
                         text: message,
                     },
                 ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-lsp-driver",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "MCP LSP Driver for IDE plugins to easily expose LSP features via an MCP server.",
   "type": "module",
   "main": "dist/index.js",
@@ -25,12 +25,18 @@
     "vscode",
     "jetbrains"
   ],
-  "author": "",
+  "author": "EFLKumo",
   "license": "MIT",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.25.1",
     "zod": "^4.3.4"
   },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/OpticLM/mcp-lspdriver-ts"
+  },
+  "peerDependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.1"
+  },
   "devDependencies": {
     "@biomejs/biome": "2.3.10",
     "@types/node": "^22.19.3",