@theupsider/lsp-mcp 0.1.3 → 0.1.5

package/README.md

@@ -41,6 +41,8 @@ A Model Context Protocol (MCP) server that gives language models access to **Lan
 
 ## Installation
 
+> **Important:** Install `lsp-mcp` on the **same machine where your code lives**. The language servers it manages need direct filesystem access to your codebase — they cannot work over a remote connection or on a different machine than your source files.
+
 ```bash
 # npm
 npm install -g @theupsider/lsp-mcp
@@ -51,6 +53,26 @@ bun install -g @theupsider/lsp-mcp
 
 ## Quickstart
 
+### VS Code / Cursor
+
+Add to your **workspace** `.vscode/mcp.json` (recommended — ensures the server runs on the same machine as your code, including SSH remotes, WSL, and Dev Containers):
+
+```json
+{
+  "servers": {
+    "lsp-mcp": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@theupsider/lsp-mcp"]
+    }
+  }
+}
+```
+
+> **Why workspace config?** VS Code runs servers defined in `.vscode/mcp.json` wherever the workspace lives. Servers defined in your user profile always run locally — which breaks LSP when your code is on a remote machine.
+
+### CLI
+
 ```bash
 # Run the server (reads from stdin, writes to stdout)
 lsp-mcp
@@ -107,7 +129,6 @@ lsp_init({ root: "/path/to/project", languages: ["python", "typescript"] })
 
 | Environment Variable | Description                         | Default      |
 | -------------------- | ----------------------------------- | ------------ |
-| `LSP_MCP_ROOT`       | Project root (auto-calls `lsp_init` on startup) | _(optional)_ |
 | `LSP_MCP_LOG_LEVEL`  | Log level: `error`, `info`, `debug` | `info`       |
 
 ## Setup Scripts
@@ -152,7 +173,7 @@ gem install solargraph
 
 ### Server not detecting language
 
-Ensure your project root contains a language marker file (e.g., `package.json` for TypeScript, `Cargo.toml` for Rust). The server scans the `LSP_MCP_ROOT` directory for these markers.
+Ensure your project root contains a language marker file (e.g., `package.json` for TypeScript, `Cargo.toml` for Rust). The server scans the directory passed to `lsp_init` for these markers.
 
 ### High memory usage
 

package/dist/__tests__/index.test.js

@@ -12,7 +12,7 @@ describe('index entrypoint', () => {
     beforeEach(() => {
         jest.clearAllMocks();
     });
-    it('starts and waits for lsp_init when LSP_MCP_ROOT is missing', async () => {
+    it('starts and waits for lsp_init', async () => {
         const stderr = jest.fn();
         const exit = jest.fn();
         const McpServer = jest.requireMock('../mcp/server').McpServer;
@@ -31,15 +31,12 @@ describe('index entrypoint', () => {
         expect(stdout).toHaveBeenCalledWith(`${version}\n`);
         expect(exit).toHaveBeenCalledWith(0);
     });
-    it('boots lifecycle, logs startup report, and starts the MCP server', async () => {
+    it('uses LSP_MCP_LOG_LEVEL and registers signals', async () => {
         const stderr = jest.fn();
         const onSignal = jest.fn();
         const McpServer = jest.requireMock('../mcp/server').McpServer;
-        await (0, index_1.main)([], { LSP_MCP_ROOT: '/workspace', LSP_MCP_LOG_LEVEL: 'debug' }, { stderr, onSignal });
-        const serverInstance = McpServer.mock.results[0]?.value;
+        await (0, index_1.main)([], { LSP_MCP_LOG_LEVEL: 'debug' }, { stderr, onSignal });
         expect(McpServer).toHaveBeenCalledWith('debug');
-        expect(serverInstance.initializeManager).toHaveBeenCalledWith('/workspace');
-        expect(stderr).toHaveBeenCalledWith(`${JSON.stringify({ languages: ['typescript'], started: ['typescript'], errors: [] })}\n`);
         expect(McpServer).toHaveBeenCalledTimes(1);
         expect(onSignal).toHaveBeenCalledTimes(2);
     });

package/dist/index.js

@@ -22,17 +22,9 @@ async function main(argv = process.argv.slice(2), env = process.env, overrides =
         exit(0);
         return;
     }
-    const projectRoot = env.LSP_MCP_ROOT;
     const logLevel = env.LSP_MCP_LOG_LEVEL ?? 'info';
     const mcpServer = new server_1.McpServer(logLevel);
-    if (projectRoot) {
-        const initialized = await mcpServer.initializeManager(projectRoot);
-        const startupReport = summarizeHealth(initialized.health);
-        stderr(`${JSON.stringify(startupReport)}\n`);
-    }
-    else {
-        stderr(`${JSON.stringify({ event: 'startup', status: 'waiting-for-init' })}\n`);
-    }
+    stderr(`${JSON.stringify({ event: 'startup', status: 'waiting-for-init' })}\n`);
     await mcpServer.start();
     const shutdown = async () => {
         await mcpServer.shutdown();
@@ -41,13 +33,6 @@ async function main(argv = process.argv.slice(2), env = process.env, overrides =
     onSignal('SIGINT', shutdown);
     onSignal('SIGTERM', shutdown);
 }
-function summarizeHealth(health) {
-    return {
-        languages: health.map((entry) => entry.language),
-        started: health.filter((entry) => entry.status === 'ready').map((entry) => entry.language),
-        errors: health.filter((entry) => entry.status === 'error' && entry.error).map((entry) => entry.error)
-    };
-}
 function readVersion() {
     const packageJsonPath = node_path_1.default.resolve(__dirname, '..', 'package.json');
     return JSON.parse((0, node_fs_1.readFileSync)(packageJsonPath, 'utf8')).version;

package/mcp.json

@@ -0,0 +1,12 @@
+{
+    "mcpServers": {
+        "lsp-mcp": {
+            "type": "stdio",
+            "command": "npx",
+            "args": [
+                "-y",
+                "@theupsider/lsp-mcp"
+            ]
+        }
+    }
+}

package/package.json

@@ -1,15 +1,21 @@
 {
   "name": "@theupsider/lsp-mcp",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Universal LSP MCP server",
   "license": "Apache-2.0",
   "type": "commonjs",
+  "mcpName": "io.github.theupsider/lsp-mcp",
+  "author": {
+    "name": "David Fischer",
+    "url": "https://davidfischer.dev"
+  },
   "main": "dist/index.js",
   "bin": {
     "lsp-mcp": "dist/index.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "mcp.json"
   ],
   "scripts": {
     "build": "tsc",
@@ -29,4 +35,4 @@
     "ts-jest": "latest",
     "typescript": "latest"
   }
-}
+}