Repository files navigation

LSP for headless AI Agents

⚠️This project is under active development. APIs and features may change without notice.

A unified MCP (Model Context Protocol) server that provides advanced code manipulation and analysis capabilities for multiple programming languages through Language Server Protocol integration.

• 🌍Multi-Language Support - Built-in TypeScript/JavaScript, extensible to any language via LSP
• 🔍Semantic Code Analysis - Go to definition, find references, type information
• 🤖AI-Optimized - Designed for LLMs with line and symbol-based interfaces

These tools work with any language that has an LSP server:

• get_hover - Get hover information (type signature, documentation) using LSP
• find_references - Find all references to symbol across the codebase using LSP
• get_definitions - Get the definition(s) of a symbol using LSP
• get_diagnostics - Get diagnostics (errors, warnings) for a file using LSP
• get_all_diagnostics - Get diagnostics (errors, warnings) for all files in the project
• rename_symbol - Rename a symbol across the codebase using Language Server Protocol
• delete_symbol - Delete a symbol and optionally all its references using LSP
• get_document_symbols - Get all symbols (functions, classes, variables, etc.) in a document using LSP
• get_workspace_symbols - Search for symbols across the entire workspace using LSP
• get_completion - Get code completion suggestions at a specific position using LSP
• get_signature_help - Get signature help (parameter hints) for function calls using LSP
• get_code_actions - Get available code actions (quick fixes, refactorings, etc.) using LSP
• format_document - Format an entire document using the language server's formatting provider

Seeexamples/ for working examples of each supported language configuration.

lsmcp provides multi-language support through Language Server Protocol (LSP) integration. The basic workflow is:

1. Install Language Server - Install the LSP server for your target language
2. Add MCP Server - Configure usingclaude mcp add command or.mcp.json

# Using presets for common languagesclaude mcp add typescript npx -- -y @mizchi/lsmcp -p typescript# Custom LSP server with --binclaude mcp add<server-name> npx -- -y @mizchi/lsmcp --bin="<lsp-command>"

lsmcp includes built-in presets for popular language servers:

• typescript - TypeScript/JavaScript (typescript-language-server)
• tsgo - TypeScript/JavaScript (tsgo - faster alternative)
• deno - Deno TypeScript/JavaScript
• pyright - Python (Microsoft Pyright)
• ruff - Python (Ruff linter as LSP)
• rust-analyzer - Rust
• fsharp - F# (fsautocomplete)
• moonbit - MoonBit
• gopls - Go (Official Go language server)

For languages not in this list, or to customize LSP server settings, seeManual Setup.

# with typeScript-language-server (stable)npm add -D typescript typescript-language-server# Recommended: use tsgo for full functionalityclaude mcp add typescript npx -- -y @mizchi/lsmcp -p typescript --bin="npx tsgo --lsp --stdio"# with @typescript/native-preview (experimental, fast)npm add -D @typescript/native-previewclaude mcp add typescript npx -- -y @mizchi/lsmcp -p typescript --bin="npx tsgo"

{"mcpServers": {"typescript": {"command":"npx","args": ["-y","@mizchi/lsmcp","-p","typescript","--bin","npx tsgo --lsp --stdio"      ]    }  }}

rustup component add rust-analyzerclaude mcp add rust npx -- -y @mizchi/lsmcp -p rust-analyzer

{"mcpServers": {"rust": {"command":"npx","args": ["-y","@mizchi/lsmcp","-p","rust-analyzer"]    }  }}

# Install gopls (official Go language server)go install golang.org/x/tools/gopls@latestclaude mcp add go npx -- -y @mizchi/lsmcp -p gopls

{"mcpServers": {"go": {"command":"npx","args": ["-y","@mizchi/lsmcp","-p","gopls"]    }  }}

dotnet tool install -g fsautocompleteclaude mcp add fsharp npx -- -y @mizchi/lsmcp -p fsharp --bin="fsautocomplete --adaptive-lsp-server-enabled"

{"mcpServers": {"fsharp": {"command":"npx","args": ["-y","@mizchi/lsmcp","-p","fsharp","--bin","fsautocomplete"      ]    }  }}

# Option 1: Using Pyright (recommended)npm install -g pyrightclaude mcp add python npx -- -y @mizchi/lsmcp -p pyright# Option 2: Using python-lsp-serverpip install python-lsp-serverclaude mcp add python npx -- -y @mizchi/lsmcp --bin="pylsp"

{"mcpServers": {"python": {"command":"npx","args": ["-y","@mizchi/lsmcp","-p","pyright"]    }  }}

# Gogo install golang.org/x/tools/gopls@latestclaude mcp add go npx -- -y @mizchi/lsmcp --bin="gopls"# C/C++# Install clangd from your package manager or LLVM releasesclaude mcp add cpp npx -- -y @mizchi/lsmcp --bin="clangd"# Java# Install jdtls (Eclipse JDT Language Server)claude mcp add java npx -- -y @mizchi/lsmcp --bin="jdtls"

For advanced users who want more control over LSP server configuration, you can set up lsmcp manually with custom settings.

{"mcpServers": {"rust-minimal": {"command":"npx","args": ["-y","@mizchi/lsmcp","--bin","rust-analyzer"      ],"env": {"RUST_ANALYZER_CONFIG":"{\"assist\":{\"importGranularity\":\"module\"},\"cargo\":{\"allFeatures\":true}}"      }    }  }}

You can configure any LSP server by providing the binary path and optional initialization options:

{"mcpServers": {"custom-lsp": {"command":"npx","args": ["-y","@mizchi/lsmcp","--bin","/path/to/your/lsp-server","--initializationOptions","{\"customOption\":\"value\"}"      ]    }  }}

For complex LSP server configurations, you can use the--config option to load settings from a JSON file:

1. Create a configuration file (e.g.,my-language.json):

{"id":"my-language","name":"My Custom Language","bin":"my-language-server","args": ["--stdio"],"initializationOptions": {"formatOnSave":true,"lintingEnabled":true,"customFeatures": {"autoImport":true    }  }}

2. Use it with lsmcp:

# Using Claude CLIclaude mcp add my-language npx -- -y @mizchi/lsmcp --config ./my-language.json# Or in .mcp.json{"mcpServers": {"my-language": {"command":"npx","args": ["-y","@mizchi/lsmcp","--config","./my-language.json"]    }  }}

This approach is useful when:

• You have complex initialization options
• You want to share configurations across projects
• You need to version control your LSP settings

Some LSP servers can be configured via environment variables:

{"mcpServers": {"configured-lsp": {"command":"npx","args": ["-y","@mizchi/lsmcp","--bin","lsp-server"],"env": {"LSP_LOG_LEVEL":"debug","LSP_WORKSPACE":"/path/to/workspace"      }    }  }}

# Using language presetsnpx @mizchi/lsmcp -p<preset> --bin'...'npx @mizchi/lsmcp --preset<preset> --bin'...'# Custom LSP servernpx @mizchi/lsmcp --bin'<lsp-command>'

# Install dependenciespnpm install# Buildpnpm build# Run testspnpmtest# Type checkpnpm typecheck# Lintpnpm lint

SeeCLAUDE.md for development guidelines.

Error: LSP server for typescript not found

npm add typescript typescript-language-server

Error: Permission denied for tool 'rename_symbol'

MIT - SeeLICENSE file for details.