O que é agent-lsp?
O agent-lsp, da Blackwell Systems, é um servidor MCP que inicia e gerencia servidores de linguagem comuns como gopls, rust-analyzer, pyright e clangd e expõe o que eles sabem a um agente de IA. Suas 66 ferramentas cobrem ir para a definição, referências, hierarquias de chamadas e de tipos, diagnósticos, renomeações e ações de código, além de chamadas compostas como blast_radius, que devolve em um passo quem chama um símbolo, e um conjunto de ferramentas de simulação que aplicam uma edição na memória e informam a mudança nos erros antes de qualquer escrita.
É um único binário em Go com licença MIT, começou em abril de 2026 e tinha cerca de 179 estrelas no GitHub e nove colaboradores na verificação. As versões são frequentes: a v0.24.2 saiu em 4 de novembro de 2026, a terceira daquele dia. O README lista 32 linguagens testadas em CI contra servidores de linguagem reais, e o pacote no npm foi baixado 484 vezes na semana até 12 de novembro de 2026.
Como instalar agent-lsp
npm install -g @blackwell-systems/agent-lsp && agent-lsp initagent-lsp vale a pena?
O agent-lsp ataca uma fraqueza real dos agentes de programação: eles procuram quem chama uma função e renomeiam símbolos com grep, e o grep não sabe que duas funções têm o mesmo nome. Um servidor de linguagem sabe, e o agent-lsp mantém um aquecido por linguagem e deixa o agente perguntar diretamente a ele. A medição do próprio autor no HashiCorp Consul, com cerca de 319.000 linhas, mostrou que uma análise de impacto levou 119 chamadas de ferramenta e 841 KB pelo servidor de linguagem, contra 5.534 chamadas e 17,7 MB com grep e leitura de arquivos.
O diferencial é conferir as edições antes de gravá-las. preview_edit e simulate_chain aplicam as mudanças na memória e dizem qual passo introduz erros novos, e o safe_apply_edit só grava se a contagem de erros não subir, recusando quando a prévia estourou o tempo ou o servidor ainda estava indexando. Skills como /lsp-refactor encadeiam análise de impacto, prévia, aplicação, build e testes, e em quatro delas o servidor bloqueia chamadas feitas fora de ordem. O Serena, rival mais conhecido, também edita por símbolo; a prévia na memória é o que o agent-lsp acrescenta.
Vale saber o que ele pode executar. run_build e run_tests rodam os comandos do seu próprio projeto, como go build, cargo test, pytest ou npm test, então um script de teste ou hook de build de um repositório não confiável roda com as suas permissões de usuário. execute_command repassa comandos do servidor de linguagem, e as ferramentas de edição gravam arquivos de código. O transporte padrão é stdio; um modo HTTP com token bearer escuta em 127.0.0.1, a menos que você escolha outra coisa, e o README recomenda não colocar o token na linha de comando.
O porém: 66 definições de ferramentas pesam bastante em qualquer cliente que carregue todas, e as comparações do README, incluindo a de que nenhuma outra ponte MCP-LSP testa linguagens em CI, são afirmações do mantenedor. As respostas vêm por padrão em GCF, o formato compacto do próprio autor, em vez de JSON, o que economiza de 30 a 84% dos tokens pelos números dele, mas acrescenta um formato que suas ferramentas talvez não leiam. Projetos em Python e TypeScript ainda precisam de um daemon de indexação em segundo plano antes que as referências sejam confiáveis.
Nossa opinião: num repositório poliglota ou muito grande, em que o agente vive quebrando chamadas, o agent-lsp merece uma tarde de testes; num projeto pequeno de uma linguagem só, a busca embutida do agente provavelmente basta.
Onde ele se destaca
Um engenheiro de plataforma que mantém um monorepo em Go de 300.000 linhas
Renomear uma função exportada e atualizar todas as chamadas sem quebrar o build
A skill /lsp-rename roda prepare_rename, mostra cada ocorrência e aplica a mudança de uma vez; depois, /lsp-verify roda go build e os testes. É gratuito; a economia está nas rodadas de CI com falha que um agente com grep costuma provocar.
Uma equipe full-stack de quatro pessoas com uma API em Go e um front-end em TypeScript
Fazer uma única sessão do agente navegar pelas duas metades do código
agent-lsp init grava uma configuração que manda arquivos .go para o gopls e .ts para o typescript-language-server. O README avisa que o TypeScript 7 não traz tsserver, então instale por enquanto o TypeScript 6 de forma global.
Uma tech lead limpando um serviço legado em Python antes de uma migração
Encontrar exports que ninguém chama e removê-los com segurança
/lsp-dead-code lista os símbolos sem referências e safe_delete_symbol devolve a contagem de erros após cada remoção. Faça isso num branch; o pyright precisa que o daemon termine de indexar antes.
Antes de decidir
- Configuração
- Instale com npm install -g @blackwell-systems/agent-lsp, Homebrew, pip, Scoop, winget ou um script de instalação via curl; depois instale os servidores de linguagem necessários e rode agent-lsp doctor e agent-lsp init, que grava a configuração MCP e as regras do agente para o seu cliente. A primeira sessão indexa o workspace, cerca de 10 segundos num projeto típico segundo o README.
- Integrações
- Claude Code, Cursor, Windsurf, Gemini CLI, Codex, Cline, Continue e Pi via stdio; qualquer cliente via Streamable HTTP. 66 ferramentas, 24 skills também expostas como prompts MCP, imagens Docker por linguagem e uma biblioteca Go para usar o cliente LSP diretamente.
- Dados e privacidade
- Roda localmente com suas permissões de usuário e lê, edita e compila os workspaces que você indicar; o código que o agente lê vai para o seu provedor de modelo. O README não descreve telemetria. O modo HTTP usa um token bearer e escuta em 127.0.0.1 por padrão; as imagens Docker rodam com um usuário sem privilégios de root.
- Custo em escala
- Gratuito sob MIT. O custo é contexto e tempo: 66 definições de ferramentas por sessão nos clientes que carregam todas, mais a memória que cada servidor de linguagem ativo exige num repositório grande.
- Limites
- A precisão depende de cada servidor de linguagem. Python e TypeScript precisam de minutos de indexação no primeiro uso, que um daemon em segundo plano mantém aquecida e que se encerra após 30 minutos ocioso. A refatoração interativa exige gopls v0.24 ou mais recente.
O que é bom
- Usa servidores de linguagem reais, então referências e renomeações entendem tipos
- Edições podem ser testadas na memória com a contagem de erros antes e depois
- Um processo atende várias linguagens na mesma sessão
- Binário único, com instalação por npm, pip, Homebrew, Scoop e winget
O que não é
- 66 ferramentas pesam no contexto dos clientes que carregam todas
- run_tests e run_build executam os scripts do próprio projeto
- A saída padrão é o formato GCF do autor, não JSON
- Projeto jovem; as comparações com rivais são do próprio autor
Ideal para
Engenheiros que usam Claude Code, Codex ou Cursor em bases de código grandes ou multilíngues e querem refatorações conferidas por um servidor de linguagem real.
Alternativas ao agent-lsp
agent-lsp: perguntas frequentes
- agent-lsp vale a pena?
- Uma ponte completa entre servidores de linguagem e agentes, que confere as edições antes de gravá-las, prejudicada por uma lista de ferramentas exagerada e por uma juventude que aparece no ritmo de versões. Damos nota 3.9 de 5.
- Quanto custa agent-lsp?
- Gratuito e de código aberto (MIT).
- Quais são as desvantagens de agent-lsp?
- 66 ferramentas pesam no contexto dos clientes que carregam todas; run_tests e run_build executam os scripts do próprio projeto; a saída padrão é o formato GCF do autor, não JSON; projeto jovem; as comparações com rivais são do próprio autor.
- Para quem agent-lsp é indicado?
- Engenheiros que usam Claude Code, Codex ou Cursor em bases de código grandes ou multilíngues e querem refatorações conferidas por um servidor de linguagem real.
- Quanto custa agent-lsp para uma equipe ou em produção?
- Gratuito sob MIT. O custo é contexto e tempo: 66 definições de ferramentas por sessão nos clientes que carregam todas, mais a memória que cada servidor de linguagem ativo exige num repositório grande.
- agent-lsp é seguro para dados da empresa?
- Roda localmente com suas permissões de usuário e lê, edita e compila os workspaces que você indicar; o código que o agente lê vai para o seu provedor de modelo. O README não descreve telemetria. O modo HTTP usa um token bearer e escuta em 127.0.0.1 por padrão; as imagens Docker rodam com um usuário sem privilégios de root.
- Quais são as melhores alternativas ao agent-lsp?
- As alternativas mais próximas que analisamos são Serena e Lean LSP MCP.
Respostas verificadas em 13 de nov. de 2026.