Vim MCP Server

vim-mcp-server

嵌入 Vim 的 MCP（Model Context Protocol）服务。它通过 HTTP 提供工具，让兼容 MCP 的客户端（例如 AI 编码 Agent）读取和修改缓冲区、移动光标、获取可视选择、管理 quickfix 和位置列表、打开并排差异视图（包括在 Vim 内计算的 git 差异）、读取消息历史记录以及运行 Ex 命令。

目前，我主要用它让 Agent 在 Vim 中为我显示文件和行。有时，我也会用它向 Agent 显示选中的区域。

要求

• Vim 编译时启用了 +python3

安装

使用你喜欢的插件管理器。

vim-plug

Plug 'breggles/vim-mcp-server'

Vundle

Plugin 'breggles/vim-mcp-server'

手动安装

将仓库克隆到 Vim 的 packages 目录：

git clone https://github.com/breggles/vim-mcp-server.git \
    ~/.vim/pack/plugins/start/vim-mcp-server

用法

启动服务

在 Vim 中运行：

:McpServerStart

在 vimrc 中添加以下内容，即可在启动 Vim 时自动启动服务：

let g:mcp_server_autostart = 1

MCP 客户端配置

将 MCP 客户端指向 http://127.0.0.1:8765/mcp（或你选择的端口）。

例如，若使用 opencode，可将服务添加到 opencode.jsonc：

"mcp": {
  "vim": {
    "type": "remote",
    "url": "http://localhost:8765/mcp",
    "enabled": true
  }
}

命令

命令	说明
:McpServerStart [port]	启动服务（默认端口为 8765）
:McpServerStop	停止服务
:McpServerStatus	显示服务状态和 URL

选项

变量	默认值	说明
g:mcp_server_port	8765	服务监听的端口
g:mcp_server_autostart	0	在 VimEnter 时自动启动服务
g:mcp_server_allow_execute	0	启用 execute_command 工具
g:mcp_server_allow_save	0	启用 save_buffer 工具
g:mcp_server_allow_edit	0	启用 edit_buffer 工具

工具

该服务向 MCP 客户端提供以下工具：

工具	说明
list_buffers	列出所有打开的缓冲区
get_buffer	读取缓冲区内容（可指定行范围）
edit_buffer	替换、插入或删除缓冲区中的行
open_file	通过 :edit 打开文件
save_buffer	通过 :write 保存缓冲区（需选择启用，见上文）
close_buffer	通过 :bdelete 关闭缓冲区
get_cursor	获取当前光标位置
set_cursor	将光标移动到指定行和列
get_visual_selection	获取当前的可视选择（如果有）
execute_command	运行任意 Ex 命令（需选择启用，见上文）
get_quickfix_list	获取当前 quickfix 列表条目
set_quickfix_list	设置 quickfix 列表
get_location_list	获取当前窗口的位置列表
set_location_list	设置当前窗口的位置列表
get_messages	获取 Vim 的消息历史记录（:messages 输出）
show_diff	在新标签页中打开并排差异视图（文件或内容）
show_git_diff	在新标签页中打开并排 git 差异视图；git 会在 Vim 内计算差异的两侧

工具接受缓冲区参数时，可以通过编号（buffer_id）或文件路径（buffer_path）指定。若两者都未提供，则使用当前缓冲区。

OpenCode 计划模式

默认情况下，OpenCode 的计划模式会禁用所有 MCP 工具。若要在计划模式下启用只读的 Vim 工具，请将以下内容添加到 opencode.jsonc 中：

{
  "agent": {
    "plan": {
      "tools": {
        "vim_*": false,
        "vim_list_buffers": true,
        "vim_get_buffer": true,
        "vim_get_cursor": true,
        "vim_get_visual_selection": true,
        "vim_open_file": true,
        "vim_set_cursor": true,
        "vim_get_quickfix_list": true,
        "vim_set_quickfix_list": true,
        "vim_get_location_list": true,
        "vim_set_location_list": true,
        "vim_get_messages": true,
        "vim_show_diff": true,
        "vim_show_git_diff": true
      }
    }
  }
}

这会先禁用所有 vim_* 工具，然后重新启用特定工具。请根据你的工作流调整 列表。

开发

若要在不安装插件的情况下使用它，请克隆仓库并将其添加到 Vim 的运行时路径中：

set rtp+=~/path/to/vim-mcp-server

将此内容添加到你的 vimrc 中，或手动运行。更改会在下次 启动 Vim 时生效。

使用以下命令生成帮助标签：

:helptags ~/path/to/vim-mcp-server/doc

许可证

MIT