agent-lsp의 개요
agent-lsp는 Blackwell Systems가 만든 MCP 서버로, gopls, rust-analyzer, pyright, clangd 같은 일반 언어 서버를 시작하고 관리하며 그 지식 을 AI 에이전트에 제공합니다. 66개 도구는 정의로 이동, 참조, 호출 계층과 타입 계층, 진단, 이름 변경, 코드 액션을 다루고, 심볼의 호출자를 한 번에 돌려주는 blast_radius 같은 복합 호출과, 편집을 메모리에서 적용해 쓰기 전에 오류 변화를 알려 주는 시뮬레이션 도구 묶음도 갖추고 있습니다.
MIT 라이선스의 단일 Go 바이너리이며, 2026년 4월에 시작했고 확인 시점에 GitHub 스타 약 179개, 기여자 9명이었습니다. 릴리스가 잦아서 v0.24.2는 2026년 11월 4일에 나왔고, 그날의 세 번째 릴리스였습니다. README는 실제 언어 서버로 CI에서 검증하는 언어 32개를 나열하며, npm 패키지는 2026년 11월 12일까지 일주일 동안 484회 다운로드되었습니다.
agent-lsp 설치 방법
npm install -g @blackwell-systems/agent-lsp && agent-lsp initagent-lsp, 쓸 만한 가치가 있습니까?
agent-lsp는 코딩 에이전트의 실제 약점을 겨냥합니다. 에이전트는 호출자를 찾고 심볼 이름을 바꿀 때 grep을 쓰는데, grep은 두 함수의 이름이 같다는 사실을 구분하지 못합니다. 언어 서버는 구분할 수 있고, agent-lsp는 언어마다 하나를 띄워 둔 채 에이전트가 직접 물어보게 합니다. 작성자가 HashiCorp Consul(약 319,000줄)에서 직접 측정한 결과, 영향 범위 분석은 언어 서버를 통하면 도구 호출 119회와 841 KB였고, grep과 파일 읽기로는 5,534회와 17.7 MB였습니다.
차별점은 쓰기 전에 편집을 검증한다는 것입니다. preview_edit와 simulate_chain은 변경을 메모리에서 적용하고 어느 단계에서 새 오류가 생기는지 알려 주며, safe_apply_edit는 오류 수가 늘지 않을 때만 쓰고, 미리 보기가 시간 초과되었거나 서버가 아직 인덱싱 중이면 거부합니다. /lsp-refactor 같은 스킬은 영향 분석, 미리 보기, 적용, 빌드, 테스트를 이어 붙이며, 그중 네 개에서는 순서를 어긴 호출을 서버가 막습니다. 더 잘 알려진 경쟁자 Serena도 심볼 단위로 편집하지만, 메모리 미리 보기는 agent-lsp가 더한 부분입니다.
무엇을 실행할 수 있는지 알아 두어야 합니다. run_build와 run_tests는 go build, cargo test, pytest, npm test 같은 프로젝트 자체의 명령을 실행하므로, 신뢰할 수 없는 저장소의 테스트 스크립트나 빌드 훅이 사용자 권한으로 돌아갑니다. execute_command는 언어 서버 명령을 그대로 전달하고, 편집 도구는 소스 파일에 씁니다. 기본 전송 방식은 stdio입니다. bearer 토큰을 쓰는 HTTP 모드는 따로 지정하지 않으면 127.0.0.1에서 대기하며, README는 토큰을 명령줄에 넣지 말라고 경고합니다.
주의할 점: 66개의 도구 정의는 전부 불러오는 클라이언트에 무거운 부담이며, 다른 MCP-LSP 브리지는 CI에서 언어를 검증하지 않는다는 주장을 포함해 README의 비교는 유지 관리자의 주장입니다. 응답은 기본적으로 JSON이 아니라 작성자가 만든 압축 형식 GCF로 나오는데, 작성자 수치로는 토큰을 30~84% 줄이지만 자체 도구가 읽지 못할 수 있는 형식이 하나 늘어납니다. Python과 TypeScript 프로젝트는 참조를 믿을 수 있게 되기까지 여전히 백그라운드 인덱싱 데몬이 필요합니다.
결론: 에이전트가 계속 호출자를 망가뜨리는 다언어 저장소나 아주 큰 저장소라면 agent-lsp에 오후 한나절을 써 볼 만합니다. 작은 단일 언어 프로젝트라면 에이전트에 내장된 검색으로 아마 충분합니다.
제 역할을 하는 곳
300,000줄짜리 Go 모노레포를 관리하는 플랫폼 엔지니어
내보낸 함수의 이름을 바꾸고 빌드를 깨뜨리지 않고 모든 호출자를 갱신하기
/lsp-rename 스킬이 prepare_rename을 실행하고 모든 위치를 보여 준 뒤 한 번에 변경을 적용하며, 이어서 /lsp-verify가 go build와 테스트를 돌립니다. 무료이며, grep을 쓰는 에이전트가 흔히 일으키는 CI 실패 반복을 줄여 줍니다.
Go API와 TypeScript 프런트엔드를 가진 4인 풀스택 팀
에이전트 세션 하나로 코드베이스 양쪽을 오가게 하기
agent-lsp init이 .go 파일은 gopls로, .ts 파일은 typescript-language-server로 보내는 설정을 씁니다. README에 따르면 TypeScript 7에는 tsserver가 없으므로 당분간 TypeScript 6을 전역으로 설치하세요.
마이그레이션 전에 오래된 Python 서비스를 정리하는 테크 리드
아무도 호출하지 않는 export를 찾아 안전하게 지우기
/lsp-dead-code가 참조가 없는 심볼을 나열하고, safe_delete_symbol이 삭제할 때마다 오류 수를 돌려줍니다. 브랜치에서 작업하세요. pyright는 먼저 데몬에서 인덱싱을 마쳐야 합니다.
도입 전 확인할 점
- 설정
- npm install -g @blackwell-systems/agent-lsp, Homebrew, pip, Scoop, winget 또는 curl 설치 스크립트로 설치하고, 필요한 언어 서버를 설치한 뒤 agent-lsp doctor와 agent-lsp init을 실행합니다. init은 클라이언트용 MCP 설정과 에이전트 규칙을 써 줍니다. README에 따르면 첫 세션의 작업 공간 인덱싱은 일반적인 프로젝트에서 약 10초입니다.
- 연동
- Claude Code, Cursor, Windsurf, Gemini CLI, Codex, Cline, Continue, Pi를 stdio로 지원하고, Streamable HTTP로는 어떤 클라이언트든 쓸 수 있습니다. 도구 66개, MCP 프롬프트로도 제공되는 스킬 24개, 언어별 Docker 이미지, LSP 클라이언트를 직접 쓰기 위한 Go 라이브러리가 있습니다.
- 데이터와 개인정보
- 사용자 권한으로 로컬에서 실행되며, 지정한 작업 공간을 읽고 편집하고 빌드합니다. 에이전트가 읽은 코드는 모델 제공업체로 갑니다. README에는 텔레메트리에 대한 설명이 없습니다. HTTP 모드는 bearer 토큰을 쓰고 기본적으로 127.0.0.1에서 대기합니다. Docker 이미지는 root가 아닌 사용자로 실행됩니다.
- 대규모 사용 시 비용
- MIT로 무료입니다. 비용은 컨텍스트와 시간으로, 전부 불러오는 클라이언트에서는 세션마다 도구 정의 66개, 그리고 큰 저장소에서 실행되는 각 언어 서버의 메모리가 더해집니다.
- 제한
- 정확도는 각 언어 서버에 달려 있습니다. Python과 TypeScript는 처음 쓸 때 인덱싱에 몇 분이 걸리며, 백그라운드 데몬이 이를 유지하다가 30분 동안 쓰지 않으면 종료됩니다. 대화형 리팩터링에는 gopls v0.24 이상이 필요합니다.
좋은 점
- 실제 언어 서버를 쓰므로 참조와 이름 변경이 타입을 이해함
- 편집을 메모리에서 미리 보고 전후 오류 수를 비교 가능
- 한 프로세스가 한 세션에서 여러 언어를 처리
- 단일 바이너리, npm, pip, Homebrew, Scoop, winget으로 설치
아쉬운 점
- 66개 도구가 전부 불러오는 클라이언트의 컨텍스트를 압박
- run_tests와 run_build가 프로젝트의 스크립트를 실행
- 출력 기본값이 JSON이 아닌 작성자의 GCF 형식
- 젊 은 프로젝트이며 경쟁 제품과의 비교는 자체 주장
추천 대상
크거나 여러 언어가 섞인 코드베이스에서 Claude Code, Codex, Cursor를 쓰며 리팩터링을 실제 언어 서버로 검증하고 싶은 엔지니어에게 맞습니다.
agent-lsp 대안
agent-lsp: 자주 묻는 질문
- agent-lsp, 쓸 만한 가치가 있습니까?
- 쓰기 전에 편집을 검증하는, 언어 서버와 에이전트 사이의 꼼꼼한 다리이지만, 지나치게 큰 도구 목록과 릴리스 속도에서 드러나는 미성숙함이 발목을 잡습니다. 평점은 5점 만점에 3.9점입니다.
- agent-lsp의 가격은 얼마입니까?
- 무료 오픈 소스(MIT)입니다.
- agent-lsp의 단점은 무엇입니까?
- 66개 도구가 전부 불러오는 클라이언트의 컨텍스트를 압박; run_tests와 run_build가 프로젝트의 스크립트를 실행; 출력 기본값이 JSON이 아닌 작성자의 GCF 형식; 젊은 프로젝트이며 경쟁 제품과의 비교는 자체 주장.
- agent-lsp에 적합한 사람은 누구입니까?
- 크거나 여러 언어가 섞인 코드베이스에서 Claude Code, Codex, Cursor를 쓰며 리팩터링을 실제 언어 서버로 검증하고 싶은 엔지니어에게 맞습니다.
- 팀이나 프로덕션 환경에서 agent-lsp의 비용은 얼마입니까?
- MIT로 무료입니다. 비용은 컨텍스트와 시간으로, 전부 불러오는 클라이언트에서는 세션마다 도구 정의 66개, 그리고 큰 저장소에서 실행되는 각 언어 서버의 메모리가 더해집니다.
- agent-lsp에 회사 데이터를 맡겨도 안전합니까?
- 사용자 권한으로 로컬에서 실행되며, 지정한 작업 공간을 읽고 편집하고 빌드합니다. 에이전트가 읽은 코드는 모델 제공업체로 갑니다. README에는 텔레메트리에 대한 설명이 없습니다. HTTP 모드는 bearer 토큰을 쓰고 기본적으로 127.0.0.1에서 대기합니다. Docker 이미지는 root가 아닌 사용자로 실행됩니다.
- agent-lsp의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Serena 및 Lean LSP MCP입니다.
답변 확인일: 2026년 11월 13일.