Neovim MCP Server

Neovim MCP Server làm gì?

Neovim MCP Server là cầu nối kết nối các trợ lý AI—như Claude Desktop hoặc bất kỳ client Model Context Protocol (MCP) nào—với một phiên bản trình soạn thảo văn bản Neovim đang chạy. Sử dụng thư viện JavaScript neovim/node-client chính thức, nó cho phép các agent AI thực hiện các tác vụ chỉnh sửa văn bản nâng cao, điều hướng file, quản lý buffer, chạy lệnh vim, tìm kiếm và nhiều hơn nữa ngay trong Neovim. Bằng cách cung cấp bộ công cụ phong phú cho cả thao tác cơ bản và nâng cao, server này giúp lập trình viên tự động hóa quy trình làm việc, ứng dụng hỗ trợ mã hóa bằng AI và quản lý mã nguồn hiệu quả—ngay trong trình soạn thảo yêu thích của họ. Đặc biệt hữu ích để tích hợp năng lực LLM vào vòng đời phát triển phần mềm, biến Neovim thành không gian làm việc thông minh tăng cường AI.

Danh sách Prompt

Không có template prompt cụ thể nào được đề cập trong tài liệu.

Danh sách tài nguyên

• nvim://session
  Đại diện cho phiên Neovim hiện tại; cung cấp ngữ cảnh về môi trường đang chạy.

• nvim://buffers
  Liệt kê tất cả buffer đang mở trong phiên Neovim hiện tại, bao gồm metadata như trạng thái chỉnh sửa, tô sáng cú pháp, và ID cửa sổ.

Danh sách công cụ

• vim_buffer
  Lấy nội dung buffer kèm số dòng. Có thể lọc theo tên file.

• vim_command
  Gửi lệnh đến Neovim để điều hướng, chỉnh sửa, và thao tác khác. Hỗ trợ lệnh shell nếu được bật.

• vim_status
  Cung cấp trạng thái tổng thể: vị trí con trỏ, chế độ, tên file, vùng chọn, bố cục cửa sổ, thư mục làm việc, thông tin LSP,…

• vim_edit
  Chỉnh sửa dòng bằng chế độ chèn, thay thế, hoặc thay thế toàn bộ.

• vim_window
  Quản lý cửa sổ Neovim (chia nhỏ, chia dọc, đóng, điều hướng).

• vim_mark
  Đặt dấu tên tại vị trí cụ thể.

• vim_register
  Đặt nội dung cho các register của Vim.

• vim_visual
  Tạo vùng chọn chế độ visual.

• vim_buffer_switch
  Chuyển đổi giữa các buffer theo tên hoặc số.

• vim_buffer_save
  Lưu buffer hiện tại hoặc lưu với tên file cụ thể.

• vim_file_open
  Mở file vào buffer mới.

• vim_search
  Tìm kiếm trong buffer hiện tại, hỗ trợ regex.

• vim_search_replace
  Tìm và thay thế với tùy chọn nâng cao.

• vim_grep
  Tìm kiếm toàn dự án bằng vimgrep với quickfix list.

• vim_macro
  Ghi, dừng và phát lại macro Vim.

• vim_tab
  Quản lý tab (tạo, đóng, chuyển, liệt kê).

• vim_fold
  Thao tác gấp/giãn code.

• vim_jump
  Điều hướng danh sách jump.

Ứng dụng của MCP Server này

• Chỉnh sửa mã tự động
  Agent AI có thể chỉnh sửa chính xác, refactor hoặc chèn đoạn mã trực tiếp trong Neovim, tăng tốc phát triển.

• Khám phá mã nguồn
  Chuyển buffer nhanh, tìm kiếm file, điều hướng dự án lớn với AI hỗ trợ—giúp hiểu mã legacy hoặc hướng dẫn người mới.

• Tự động hóa quy trình làm việc
  Tự động hóa tác vụ lặp lại như format, gấp code, quản lý tab/cửa sổ, tăng năng suất và giảm lỗi thủ công.

• Chẩn đoán lỗi và giám sát sức khỏe
  Sử dụng AI để phát hiện, làm nổi bật và hỗ trợ sửa lỗi trong mã hoặc quy trình làm việc bằng các công cụ trạng thái, giám sát sức khỏe.

• Tìm kiếm và thay thế nâng cao
  Thực hiện tìm kiếm/thay thế phức tạp toàn dự án với regex và xác nhận, giảm công sức thủ công và tăng độ chính xác.

Hướng dẫn thiết lập

Windsurf

1. Đảm bảo Node.js đã được cài đặt trên máy.
2. Mở hoặc tạo file cấu hình Windsurf.
3. Thêm mục Neovim MCP Server vào đối tượng mcpServers:

   "mcpServers": {
     "neovim": {
       "command": "npx",
       "args": ["@bigcodegen/mcp-neovim-server@latest"]
     }
   }
   

4. Lưu cấu hình và khởi động lại Windsurf.
5. Kiểm tra server đã xuất hiện trong danh sách MCP server khả dụng.

Ví dụ bảo mật API key

"mcpServers": {
  "neovim": {
    "command": "npx",
    "args": ["@bigcodegen/mcp-neovim-server@latest"],
    "env": {
      "MY_API_KEY": "${MY_API_KEY}"
    },
    "inputs": {
      "socket": "/tmp/nvim"
    }
  }
}

Claude

1. Đảm bảo bạn đã cài Node.js.
2. Tìm file cấu hình Claude.
3. Thêm Neovim MCP server trong phần mcpServers.

   "mcpServers": {
     "neovim": {
       "command": "npx",
       "args": ["@bigcodegen/mcp-neovim-server@latest"]
     }
   }
   

4. Lưu và khởi động lại Claude.
5. Kiểm tra danh sách MCP server để xác nhận Neovim xuất hiện.

Cursor

1. Cài Node.js nếu chưa có.
2. Mở file cấu hình Cursor.
3. Thêm Neovim MCP Server vào mcpServers:

   "mcpServers": {
     "neovim": {
       "command": "npx",
       "args": ["@bigcodegen/mcp-neovim-server@latest"]
     }
   }
   

4. Lưu và khởi động lại Cursor.
5. Xác nhận Neovim MCP Server đã hoạt động.

Cline

1. Đảm bảo Node.js đã thiết lập.
2. Chỉnh sửa file cấu hình Cline.
3. Thêm mục Neovim MCP server:

   "mcpServers": {
     "neovim": {
       "command": "npx",
       "args": ["@bigcodegen/mcp-neovim-server@latest"]
     }
   }
   

4. Lưu và khởi động lại Cline.
5. Kiểm tra server hoạt động với công cụ.

Lưu ý:
Bảo mật API key bằng cách tham chiếu biến môi trường trong cấu hình (khối env), như ví dụ phía trên.

Cách sử dụng MCP này trong flow

Sử dụng MCP trong FlowHunt

Để tích hợp MCP server vào quy trình FlowHunt, bắt đầu bằng cách thêm thành phần MCP vào flow và kết nối với agent AI của bạn:

Nhấn vào thành phần MCP để mở bảng cấu hình. Trong phần cấu hình MCP hệ thống, chèn thông tin MCP server của bạn theo định dạng JSON sau:

{
  "neovim": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Sau khi cấu hình, agent AI có thể sử dụng MCP này như một công cụ với đầy đủ chức năng và năng lực. Hãy nhớ đổi “neovim” thành tên MCP server thực tế của bạn và thay URL bằng địa chỉ server MCP của bạn.

Tổng quan

Đánh giá của chúng tôi

MCP server này được tài liệu hóa tốt, cung cấp bộ công cụ Neovim phong phú, có tài nguyên hữu ích và hướng dẫn cài đặt rõ ràng cho nhiều nền tảng. Tuy nhiên, thiếu template prompt rõ ràng và chưa đề cập đến tính năng MCP nâng cao như roots hoặc sampling. Nhìn chung, đây là lựa chọn thực tế và mạnh mẽ cho tự động hóa Neovim bằng AI, dù vẫn còn không gian để hoàn thiện giao thức.

MCP Score