Neovim MCP 서버

Claude Desktop(또는 모든 클라이언트)과 Neovim 간의 개념 증명 통합은 Model Context Protocol(MCP)과 공식 neovim/node-client JavaScript 라이브러리를 사용합니다. 이 서버는 Claude가 이미 이해하고 있는 Vim의 기본 텍스트 편집 명령과 워크플로를 활용하여 가벼운 코드 또는 범용 AI 텍스트 지원 계층을 생성합니다.

특징

예를 들어 nvim을 시작할 때 --listen /tmp/nvim 과 같이 소켓 파일을 노출하면 nvim 인스턴스에 연결합니다.
현재 버퍼를 봅니다
커서 위치, 모드, 파일 이름을 가져옵니다.
vim 명령을 실행하고 선택적으로 vim을 통해 셸 명령을 실행합니다.
삽입이나 교체를 사용하여 편집할 수 있습니다.

Related MCP server: MCP Code Analyzer

API

자원

nvim://session : 현재 neovim 텍스트 편집기 세션
nvim://buffers : 수정된 상태, 구문 및 창 ID를 포함한 메타데이터가 포함된 현재 Neovim 세션의 모든 열려 있는 버퍼 목록

도구

vim_버퍼
- 줄 번호가 표시된 현재 VIM 텍스트 편집기 버퍼
- 입력 filename (문자열)
- 파일 이름은 무시되고 현재 활성 버퍼 콘텐츠가 포함된 번호가 매겨진 줄의 문자열이 반환됩니다.
vim_명령
- VIM에 탐색, 스팟 편집 및 줄 삭제를 위한 명령 보내기
- 입력 command (문자열)
- nvim.replaceTermcodes 통해 전달된 vim 명령을 실행합니다. 여러 명령을 줄바꿈으로 구분하면 작동합니다.
- 오류가 발생하면 'nvim:errmsg' 내용이 반환됩니다.
vim_상태
- VIM 편집기의 상태를 가져옵니다
- 상태에는 커서 위치, 모드, 파일 이름, 시각적 선택, 창 레이아웃, 현재 탭, 표시, 레지스터 및 작업 디렉토리가 포함됩니다.
vim_edit
- VIM 편집기에서 insert, replace 또는 replaceAll을 사용하여 줄을 편집합니다.
- 입력 startLine (숫자), mode ( "insert" | "replace" | "replaceAll" ), lines (문자열)
- insert는 startLine에 줄을 삽입합니다.
- replace는 startLine에서 시작하는 줄을 바꿉니다.
- replaceAll은 버퍼 내용 전체를 교체합니다.
vim_window
- Neovim 창 조작(분할, vssplit, 닫기, 탐색)
- 입력 command (문자열: "split", "vsplit", "only", "close", "wincmd h/j/k/l")
- 창 관리 작업을 허용합니다
vim_mark
- 특정 위치에 표시를 설정하세요
- 입력 mark (문자열: az), line (숫자), column (숫자)
- 지정된 위치에 명명된 마크를 설정합니다.
vim_register
- 레지스터의 내용 설정
- 입력 register (문자열: az 또는 "), content (문자열)
- 등록 내용을 관리합니다
vim_visual
- 시각적으로 선택하기
- 입력 startLine (숫자), startColumn (숫자), endLine (숫자), endColumn (숫자)
- 시각적 모드 선택을 생성합니다

클로드는 이 간단한 도구 세트를 사용하여 neovim 세션을 들여다보고 질문에 답하고 버퍼를 편집할 수 있습니다.

제한 사항

이는 모델 컨텍스트 프로토콜을 실험하기 위한 간단한 개념 증명입니다. 사용 시 발생하는 모든 책임은 사용자에게 있습니다.
사용자 정의 neovim 구성과 원활하게 상호 작용하지 않을 수 있습니다!
오류 처리가 개선될 수 있습니다.
가끔 클로드는 vim 명령 입력을 제대로 받지 못할 때가 있습니다.

구성

환경 변수

ALLOW_SHELL_COMMANDS : 셸 명령(예: !ls ) 실행을 활성화하려면 'true'로 설정합니다. 보안을 위해 기본값은 false입니다.
NVIM_SOCKET_PATH : Neovim 소켓 경로를 설정합니다. 지정하지 않으면 기본값은 '/tmp/nvim'입니다.