# Vsc Lsp Mcp > VSCode LSP MCP - **Type:** MCP server - **Install:** `agentstack add mcp-beixiyo-vsc-lsp-mcp` - **Verified:** Yes β€” security-reviewed for prompt injection and unsafe behavior - **Seller:** [beixiyo](https://agentstack.voostack.com/s/beixiyo) - **Installs:** 0 - **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [beixiyo](https://github.com/beixiyo) - **Source:** https://github.com/beixiyo/vsc-lsp-mcp ## Install ```sh agentstack add mcp-beixiyo-vsc-lsp-mcp ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # VSCode LSP MCP English | δΈ­ζ–‡ ## πŸ” Overview VSCode LSP MCP is a Visual Studio Code extension that exposes Language Server Protocol (LSP) features through the Model Context Protocol (MCP). **Extension ID**: `cjl.lsp-mcp` β€” open Extensions (`Ctrl+Shift+X` / `Cmd+Shift+X`) and search for **cjl.lsp-mcp** to find this plugin precisely. This allows AI assistants and external tools to utilize VSCode's powerful language intelligence capabilities without direct integration. ### 🌟 Why This Extension? Large language models like Claude and Cursor struggle to understand your codebase accurately because: - They rely on regex patterns to find symbols, leading to false matches - They can't analyze import/export relationships properly - They don't understand type hierarchies or inheritance - They have limited code navigation capabilities This extension bridges that gap, providing AI tools with the same code intelligence that VSCode uses internally! ## βš™οΈ Features - πŸ”„ **LSP Bridge**: Converts LSP features into MCP tools - πŸ€– **VS Code Copilot integration**: Registers the local MCP server directly with VS Code Chat / Copilot - πŸ”Œ **Multi-Instance Support**: Automatically handles port conflicts for multiple VSCode windows - 🧠 **16 LSP operations** covering navigation (definition, declaration, implementation, references), documentation (hover, completions), structure (document/workspace symbols, call hierarchy), and manipulation (rename) - β˜• **Java dependency source**: Get decompiled Java class source via jdt:// URI (from jdtls), so AI can read library implementations - πŸ“„ **Dual output format**: JSON for machine processing, Markdown for LLM-friendly reading ## πŸ› οΈ Exposed MCP Tools | Operation | Description | |-----------|-------------| | `hover` | Get hover information (documentation, type, etc.) at a position | | `definition` | Get the definition location of a symbol | | `declaration` | Get the declaration location of a symbol | | `implementation` | Get the implementation location(s) of a symbol | | `references` | Find all references to a symbol | | `completions` | Get intelligent code completion suggestions | | `document_symbols` | Get the symbol outline (tree) of a document | | `workspace_symbols` | Search for symbols across the entire workspace by query | | `class_file_contents` | Get decompiled Java class source via jdt:// URI (from jdtls), to read library/dependency implementations | | `rename` | Rename a symbol across the workspace | | `symbol_at_position` | Get symbol metadata (name, kind, range) at a position | | `incoming_calls` | Find all callers of a symbol | | `outgoing_calls` | Find all callees (calls made by) a symbol | All operations are invoked through the single `execute_lsp` MCP tool with a unified input format: - `operation` β€” which LSP operation to execute - `uri` β€” file path or URI string (supports both plain paths and `file://`/`jdt://` URIs) - `line` β€” line number (**1-based**, matching editor display). Required for position-dependent operations - `character` β€” character offset (**1-based**, matching editor display). Required for position-dependent operations - `newName` β€” required only for `rename` - `query` β€” required only for `workspace_symbols` > **1-based positions**: Both input and output use 1-based line/character values, matching what your editor displays. VS Code shows `Ln 9, Col 16` β†’ pass `line: 9, character: 16`. Output positions can be used directly as input for the next call β€” no conversion needed. ## πŸ“‹ Configuration | Key | Description | Type | Default | | ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | ------- | | `lsp-mcp.enabled` | Enable or disable the LSP MCP server. | `boolean` | `true` | | `lsp-mcp.port` | Port for the LSP MCP server. | `number` | `9527` | | `lsp-mcp.maxRetries` | Maximum number of port retry attempts when the default port is occupied. | `number` | `10` | | `lsp-mcp.cors.enabled` | Enable or disable CORS (Cross-Origin Resource Sharing). | `boolean` | `true` | | `lsp-mcp.cors.allowOrigins` | Allowed origins for CORS. Use `*` to allow all origins, or provide a comma-separated list of origins (e.g., `http://localhost:3000,http://localhost:5173`). | `string` | `*` | | `lsp-mcp.cors.withCredentials` | Whether to allow credentials (cookies, authorization headers) in CORS requests. | `boolean` | `false` | | `lsp-mcp.cors.exposeHeaders` | Headers that browsers are allowed to access. Provide a comma-separated list of headers (e.g., `Mcp-Session-Id`). | `string` | `Mcp-Session-Id` | | `lsp-mcp.maxResults` | Maximum number of items returned for list-type results (completions, workspace_symbols, etc.). Prevents excessive token usage. | `number` | `200` | | `lsp-mcp.outputFormat` | Output format for LSP operation results. `json` for machine-readable JSON, `markdown` for LLM-friendly Markdown. | `string` | `json` | ## πŸ”— Integration with AI Tools ### VS Code Copilot No `mcp.json` setup is required. After the extension starts, it registers the local LSP MCP server with VS Code through an MCP server definition provider. Use **MCP: List Servers** or the chat tools picker in VS Code to enable or manage the **LSP MCP Server**. ### Cursor Config file: `~/.cursor/mcp.json` (e.g. `%USERPROFILE%\.cursor\mcp.json` on Windows) ```json { "mcpServers": { "lsp-mcp": { "url": "http://127.0.0.1:9527/mcp" } } } ``` ### OpenCode Config file: `~/.config/opencode/opencode.jsonc` ```json { "mcp": { "lsp-mcp": { "type": "remote", "url": "http://127.0.0.1:9527/mcp", "enabled": true } } } ``` ### Claude Code Config file: `~/.claude.json` ```json { "mcpServers": { "lsp-mcp": { "type": "http", "url": "http://127.0.0.1:9527/mcp" } } } ``` ### Gemini | IFlow Config file: `~/.gemini/settings.json` ```json { "mcpServers": { "lsp-mcp": { "type": "streamable-http", "httpUrl": "http://127.0.0.1:9527/mcp" } } } ``` ### Codex Config file: `~/.codex/config.toml` ```toml [mcp_servers.lsp-mcp] url = "http://127.0.0.1:9527/mcp" ``` ### Roo Code ```json { "mcpServers": { "lsp-mcp": { "type": "streamable-http", "url": "http://127.0.0.1:9527/mcp", "disabled": false } } } ``` --- ## πŸ’» Development - Clone the repository - Run `pnpm install` - Run `pnpm run update` to generate metadata - Press `F5` to start debugging ## Source & license This open-source MCP server is cataloged on AgentStack and links to its original source β€” we do not rehost the code. - **Author:** [beixiyo](https://github.com/beixiyo) - **Source:** [beixiyo/vsc-lsp-mcp](https://github.com/beixiyo/vsc-lsp-mcp) - **License:** MIT Install and usage instructions live in the source repository linked above. ## Pricing - **Free** β€” Free ## Security capabilities Automated source analysis of v0.1.0 β€” what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source β€” more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** β€” security scan: passed β€” Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/mcp-beixiyo-vsc-lsp-mcp - Seller: https://agentstack.voostack.com/s/beixiyo - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack β€” the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.