mcpserver.nvim

mcpserver.nvim

一个实现 MCP（Model Context Protocol）服务的 Neovim 插件，允许外部 MCP 客户端通过 Unix 套接字与 Neovim 交互。

功能

• get_buffer_content：获取当前缓冲区的内容

安装

使用 lazy.nvim：

{
  dir = "/path/to/mcpserver.nvim", -- Use your local path
  -- Server starts automatically on VimEnter
}

使用方法

Neovim 插件

手动控制

启动 MCP 服务：

:MCPServerStart

停止 MCP 服务：

:MCPServerStop

获取套接字路径

local mcpserver = require('mcpserver')
local socket_path = mcpserver.get_socket_path()
print(socket_path) -- e.g., "/tmp/nvim-mcp-server-12345.sock"

套接字位置

服务会在 /tmp/nvim-mcp-server-<PID>.sock 创建一个唯一的 Unix 套接字，其中 <PID> 是 Neovim 进程 ID。这样可以同时运行多个 Neovim 实例的 MCP 服务。

独立 MCP 服务

供通过 stdio 通信的外部 MCP 客户端使用：

# Auto-detect running Neovim instance
lua standalone.lua

# Specify Neovim socket path
lua standalone.lua /tmp/nvim-mcp-server-12345.sock

独立服务：

• 通过 stdio 通信（基于 stdin/stdout 的 JSON-RPC）
• 自动检测正在运行的 Neovim MCP 服务套接字
• 将请求转发到 Neovim 实例
• 可与任何支持 stdio 传输的 MCP 客户端配合使用

可用工具

get_buffer_content

返回包含以下内容的 JSON：

• filename：当前缓冲区文件的路径
• content：缓冲区的完整文本内容
• line_count：缓冲区的行数

MCP 客户端用法

直接套接字连接

连接到 /tmp/nvim-mcp-server-<PID>.sock 处的 Unix 套接字，并使用标准 MCP 协议：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_buffer_content",
    "arguments": {}
  }
}

Stdio 连接

使用独立服务连接基于 stdio 的 MCP 客户端：

echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_buffer_content","arguments":{}}}' | lua standalone.lua

开发

插件结构：

• lua/mcpserver/init.lua：MCP 服务核心实现
• lua/mcpserver/tools.lua：工具实现
• plugin/mcpserver.lua：插件设置和命令
• standalone.lua：用于 stdio 通信的独立 MCP 服务

要求

• 支持 Lua 的 Neovim
• 独立模式需要：用于 Unix 套接字通信的 netcat（nc）