LSP Tools MCP
code-yeongyu/lsp-tools-mcp
Ferramentas LSP expostas como servidor MCP para análise e refatoração de código
Ver no GitHubServidor MCP que expõe ferramentas do Language Server Protocol (LSP) como um servidor stdio standalone. Fornece acesso a diagnósticos, navegação de código, busca de referências, renomeação e outras operações de análise de código através de uma interface padronizada.
Instalação
npx convez-ai code-yeongyu/lsp-tools-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Integração de capacidades de análise de código em agentes IA
- Diagnóstico automático de erros de sintaxe e type checking
- Navegação e busca de referências em bases de código grandes
- Refatoração assistida (renomeação segura de símbolos)
- Análise de workspace para extração de estrutura de código
Veredito

Ferramenta bem arquitetada e reutilizável para expor capacidades de LSP via MCP, com suporte a múltiplos servidores de linguagem. Ideal para quem precisa integrar análise de código profunda em agentes, mas requer configuração e conhecimento de LSP.
README
A tradução para o português deste README ainda está na fila.
lsp-tools-mcp
Standalone Language Server Protocol tools exposed as a stdio MCP server.
Used By
This package is the upstream source of truth for two downstream plugins. Codex consumes the repository-level package directly; OpenCode consumes the same runtime as a built-in MCP package.
| Project | Path | Role |
|---|---|---|
| codex-lsp | packages/lsp-tools-mcp/ | Codex plugin that reuses these LSP MCP tools plus a Codex-specific PostToolUse diagnostics hook. |
oh-my-openagent (a.k.a. oh-my-opencode) | vendor/lsp-tools-mcp/ | OpenCode plugin that registers this server as a built-in Tier-1 stdio MCP. Exposes lsp_diagnostics, lsp_goto_definition, lsp_find_references, lsp_symbols, lsp_prepare_rename, lsp_rename, and lsp_status to all agents. |
If you fix or extend the LSP runtime here, downstream adapters should reuse this package. Do not fork the runtime into a downstream; land changes here instead.
Quick Start
npm install
npm run check
npm test
npm run build
printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node dist/cli.js mcp
MCP Tools
This server exposes the following tools:
lsp.statuslsp.diagnosticslsp.goto_definitionlsp.find_referenceslsp.symbolslsp.prepare_renamelsp.rename
Tool aliases are also available for compatibility:
lsp_statuslsp_diagnosticslsp_goto_definitionlsp_find_referenceslsp_symbolslsp_prepare_renamelsp_rename
When an MCP host registers this server under the name lsp (the default in both downstreams), the tools are exposed to agents as lsp_status, lsp_diagnostics, and so on, matching the alias names above.
Configuration
Default config paths (matches codex-lsp's historical layout):
- Project:
.codex/lsp-client.json - User:
~/.codex/lsp-client.json
Path overrides via environment variables:
LSP_TOOLS_MCP_PROJECT_CONFIGLSP_TOOLS_MCP_USER_CONFIG
Examples (oh-my-openagent points the project config at .opencode/lsp.json via the env var):
LSP_TOOLS_MCP_PROJECT_CONFIG=.opencode/lsp.json node dist/cli.js mcp
LSP_TOOLS_MCP_USER_CONFIG=.opencode/lsp.json node dist/cli.js mcp
Example config file:
{
"lsp": {
"typescript": {
"command": ["typescript-language-server", "--stdio"],
"extensions": [".ts", ".tsx", ".js", ".jsx"]
}
}
}
Architecture
src/lsp/*standalone LSP runtime (process management, JSON-RPC transport, configuration, diagnostics, workspace edits)src/tools.tsMCP tool definitions and handlerssrc/mcp.tsstdio MCP server entry and registrationsrc/cli.tsstandalone CLI entry (mcpsubcommand only)
Local Development
npm install
npm run check
npm test
npm pack --dry-run