LSP

MCP server for LSP - providing IDE refactoring capabilities to coding agents

typescript

6

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "sminnee-lsp-mcp": {
      "command": "mcp-lsp",
      "args": []
    }
  }
}

You have a Language Server Protocol MCP server that exposes powerful refactoring capabilities as MCP tools. It integrates with MCP clients like Claude Code to let you perform renames, moves, extractions, and references searches directly from your editor or IDE workflow.

How to use

Connect the LSP MCP server to your MCP client and start issuing refactoring requests through your editor or client interface. You can request operations such as renaming symbols, moving functions between files, extracting selected code into new functions, and finding all references to symbols. When you are ready, you can perform a quick setup to enable a seamless workflow with Claude Code using the MCP interface.

How to install

Prerequisites include Node.js tooling and language servers for full functionality.

npm install -g lsp-mcp-server

For local development, clone the project, install dependencies, build, and link for global use.

git clone <repository-url>
cd lsp-mcp-server
pnpm install
pnpm run build
npm link

If you prefer to run without linking, you can start directly or use a dev workflow.

pnpm start

pnpm run dev

Prerequisites for TypeScript/JavaScript and Python language servers are recommended for full functionality.

npm install -g typescript-language-server typescript

npm install -g pyright

Optional:

pip install ruff

Additional notes

Usage with Claude Code is streamlined via a quick setup command when the server is installed globally.

Manual MCP server usage is available through stdio by running the server directly with the MCP client.

Available tools

rename_file

Rename files or folders using LSP rename capabilities to update paths and references consistently across the project.

move_function

Move functions between files while preserving references and dependencies, updating imports and usages accordingly.

extract_function

Extract a selected block of code into a new function, creating a clean, reusable abstraction.

find_references

Find all references to a symbol across the workspace to understand its usage and impact of changes.

rename_symbol

Rename symbols across all files, ensuring consistent naming and updated references.