Skip to main content
Glama
Sign In
OpticLM

lsp-mcp

by OpticLM
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

lsp-mcp

npx -y @opticlm/lsp-mcp

An MCP server that exposes a single Language Server Protocol server to agents as a headless editor.

lsp-mcp starts the language server you provide, keeps its document state in sync with the workspace, and exposes the language server's capabilities through MCP tools and resources. It is written in TypeScript and Effect.

Features

  • stdio and Streamable HTTP MCP transports

  • MCP 2026-07-28 stateless requests and earlier protocols with sessions

  • Diagnostics exposed both as a tool and subscribable MCP resources

  • Preview-by-default edits for rename and formatting, with explicit disk application

  • Language-server crash supervision, restart backoff, and document reopening

  • Initialization options, workspace settings, language-id mappings, and open-document capacity configuration

Underlying techniques:

  • On-demand document opening, disk change detection, and an LRU cache of open documents

  • 1-based line and column positions designed for agent-facing use

  • Capability-aware tool registration: unsupported LSP features are not advertised

Related MCP server: Codex LSP Bridge

Usage

The general form is:

npx -y @opticlm/lsp-mcp [lsp-mcp options] -- <language-server> [language-server args...]

The -- separates lsp-mcp options from the executable and arguments passed to the language server.

stdio

stdio is the default transport and is suitable for MCP clients that launch a local server process:

npx -y @opticlm/lsp-mcp --root /path/to/project -- typescript-language-server --stdio

For example, an MCP client configuration can point at the checkout like this:

{
  "mcpServers": {
    "typescript": {
      "command": "npx",
      "args": [
        "-y",
        "@opticlm/lsp-mcp",
        "--root",
        "/path/to/project",
        "--",
        "typescript-language-server",
        "--stdio"
      ]
    }
  }
}

Streamable HTTP

Run the MCP endpoint on a local port with --http:

npx -y @opticlm/lsp-mcp --http 9010 --root ./crate -- rust-analyzer

The endpoint is available at:

http://localhost:9010/mcp

Configuration examples

# Pass JSON initialization options to the language server.
npx -y @opticlm/lsp-mcp \
  --init-options '{"typescript":{"useInferredProjectPerProjectRoot":true}}' \
  -- typescript-language-server --stdio

# Serve workspace/configuration and didChangeConfiguration with JSON settings.
npx -y @opticlm/lsp-mcp \
  --settings '{"gopls":{"staticcheck":true}}' \
  -- gopls

# Add a file-extension to language-id mapping.
npx -y @opticlm/lsp-mcp --language vue=vue --root ./web -- vue-language-server --stdio

# Keep more documents open, and always restart a crashed language server.
npx -y @opticlm/lsp-mcp --open-documents 64 --restart always -- clangd

Development

Requirements:

  • Node.js 26+

  • pnpm 12.4.2+

pnpm test   # Run the Vitest suite, including the fixture LSP integration tests
pnpm check  # Type-check without emitting JavaScript
pnpm lint   # Format and lint with Biome

The main source layout is:

src/Model.ts      Agent-facing schemas and 1-based positions
src/Tools.ts      MCP tool definitions and capability gating
src/Resources.ts  MCP resources and notifications
src/Server.ts     Effect layer composition and transports
src/main.ts       CLI entry point
src/lsp/          LSP process, document, diagnostic, and editor bridge
test/             Unit and integration tests with a fixture language server

The vscode-* packages are intentionally confined to src/lsp/; the rest of the application uses the agent-facing schemas and Effect services.

License

MIT

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • VSCode Language Server MCP

    aaddrick
    F
    license
    Not graded
    quality
    Not graded
    maintenance
    Exposes VSCode's Language Server Protocol features through MCP, enabling AI assistants to perform language-aware operations like symbol navigation, reference tracking, safe renaming, type information retrieval, and hover documentation across codebases.
    -

  • Codex LSP Bridge

    CesarPetrescu
    A
    license
    Not graded
    quality
    D
    maintenance
    Exposes Language Server Protocol (LSP) features as MCP tools, enabling IDE-grade semantic navigation including go-to-definition, find references, hover info, and symbols across multiple programming languages (Python, Rust, C/C++, TypeScript/JavaScript, React, HTML, CSS).
    4
    MIT

  • lsp-mcp

    afriemann
    A
    license
    Not graded
    quality
    B
    maintenance
    An MCP server that exposes LSP-backed code navigation and editing tools to LLM agents using a single global config file to route file extensions to language servers.
    1
    MIT

  • Deixis

    jolars
    A
    license
    Not graded
    quality
    A
    maintenance
    Enables coding agents to access Language Server Protocol operations such as hover, definitions, references, and rename through typed MCP tools.
    2
    Apache 2.0