Neovim MCP Server

Neovim MCP Server

site icon
2025.02.17 0
JavaScript代码编辑器集成AI辅助编程开发效率
bigcodegen_mcp-neovim-server 是一个基于 Model Context Protocol (MCP) 的概念验证项目,旨在实现 Claude Desktop 与 Neovim 的集成。它利用 Vim 的原生文本编辑命令和工作流,为开发者提供一个轻量级的代码辅助层。
View on GitHub

Overview

基本能力

产品定位

bigcodegen_mcp-neovim-server 是一个用于 Neovim 的 MCP 服务器,旨在通过 Claude Desktop 提供代码编辑辅助功能。

核心功能

  • 连接到 Neovim 实例(需通过 --listen /tmp/nvim 启动 Neovim)
  • 查看当前缓冲区内容
  • 获取光标位置、模式、文件名等信息
  • 运行 Vim 命令
  • 通过插入或替换方式进行文本编辑

适用场景

  • 开发者希望在 Neovim 中集成 AI 辅助代码编辑功能
  • 需要快速原型验证 MCP 协议在代码编辑器中的应用

工具列表

  • vim_buffer: 显示当前 VIM 文本编辑器缓冲区的带行号内容
  • vim_command: 向 VIM 发送导航、点编辑和行删除等命令
  • vim_status: 获取 VIM 编辑器的状态(包括行、列、模式、文件名和视觉选择)
  • vim_edit: 使用插入或替换模式编辑 VIM 中的行

常见问题解答

  • 这是一个快速概念验证项目,使用时需自行承担风险
  • 可能与自定义的 Neovim 配置不兼容
  • 套接字连接处理可能不完善
  • 错误处理有待改进
  • Vim 命令输入和输出处理需要优化
  • 目前不支持多缓冲区/窗口

使用教程

使用依赖

需要安装 Node.js 和 Neovim(需通过 --listen /tmp/nvim 启动)

安装教程

  1. 确保已安装 Node.js 和 npm
  2. 通过 npm 安装 mcp-neovim-server:
npm install -g mcp-neovim-server

配置 Claude Desktop

claude_desktop_config.json 中添加以下配置:

{
  "mcpServers": {
    "MCP Neovim Server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-neovim-server"
      ]
    }
  }
}

调试方式

  1. 确保 Neovim 已通过 --listen /tmp/nvim 启动
  2. 运行 mcp-neovim-server:
npx mcp-neovim-server
  1. 检查 Claude Desktop 是否成功连接到服务器

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。