Neovim MCP Server

Instructions

Implementation Reference

• lib/nvim-operations.js:95-122 (handler)

  Core implementation of listing open buffers: connects to Neovim instances in current dir, fetches listed buffers with path, bufnr, cwd.
  export async function listOpenBuffers() { const instances = await getNvimInstancesInCwd(); const allBuffers = []; for (const { nvim, cwd } of instances) { try { const buffers = await nvim.buffers; for (const buf of buffers) { const listed = await nvim.call("buflisted", [buf.id]); if (listed) { const name = await buf.name; if (name) { allBuffers.push({ path: name, bufnr: buf.id, cwd, }); } } } } catch (error) { console.error("Error listing buffers:", error.message); } } return allBuffers; }
• index.js:215-225 (handler)

  MCP CallToolRequestSchema handler: invokes listOpenBuffers() and returns JSON-formatted buffer list as text content.
  if (name === "list_nvim_buffers") { const buffers = await listOpenBuffers(); return { content: [ { type: "text", text: JSON.stringify(buffers, null, 2), }, ], }; }
• index.js:114-122 (registration)

  Tool registration in ListToolsRequestSchema response, including name, description, and empty input schema.
  { name: "list_nvim_buffers", description: "List all open buffers in Neovim instances running in the current directory", inputSchema: { type: "object", properties: {}, }, },
• index.js:118-121 (schema)

  Input schema definition for the list_nvim_buffers tool (no parameters required).
  inputSchema: { type: "object", properties: {}, },
• lib/nvim-operations.js:36-62 (helper)

  Helper function to find and connect to Neovim instances running in the current working directory, used by listOpenBuffers.
  export async function getNvimInstancesInCwd() { const cwd = process.cwd(); const sockets = await findNvimSockets(); const instances = []; for (const socketPath of sockets) { try { const nvim = attach({ socket: socketPath }); const instanceCwd = await nvim.call("getcwd", []); // Check if this nvim instance is in our current directory if (instanceCwd === cwd || instanceCwd.startsWith(cwd + "/")) { instances.push({ socket: socketPath, cwd: instanceCwd, nvim, }); } // Note: We don't quit non-matching instances, just skip them } catch (error) { // Failed to connect to this socket, skip it continue; } } return instances; }