mcp-neovim-server

Instructions

Implementation Reference

• src/neovim.ts:499-513 (handler)

  Core handler function that validates the command and executes it directly on the Neovim instance using nvim.command().

  public async manipulateWindow(command: string): Promise<string> {
    const validCommands = ['split', 'vsplit', 'only', 'close', 'wincmd h', 'wincmd j', 'wincmd k', 'wincmd l'];
    if (!validCommands.some(cmd => command.startsWith(cmd))) {
      return 'Invalid window command';
    }
  
    try {
      const nvim = await this.connect();
      await nvim.command(command);
      return 'Window command executed';
    } catch (error) {
      console.error('Error manipulating window:', error);
      return 'Error executing window command';
    }
  }

• src/index.ts:188-213 (registration)

  MCP server registration of the 'vim_window' tool, including description, input schema, and wrapper handler that calls the core implementation.

  server.tool(
    "vim_window",
    "Manage Neovim windows: split, close, and navigate between windows",
    { 
      command: z.enum(["split", "vsplit", "only", "close", "wincmd h", "wincmd j", "wincmd k", "wincmd l"])
        .describe("Window manipulation command: split or vsplit to create new window, only to keep just current window, close to close current window, or wincmd with h/j/k/l to navigate between windows")
    },
    async ({ command }) => {
      try {
        const result = await neovimManager.manipulateWindow(command);
        return {
          content: [{
            type: "text",
            text: result
          }]
        };
      } catch (error) {
        return {
          content: [{
            type: "text",
            text: error instanceof Error ? error.message : 'Error manipulating window'
          }]
        };
      }
    }
  );

• src/index.ts:191-194 (schema)

  Zod input schema defining the allowed 'command' enum values for the vim_window tool.

  { 
    command: z.enum(["split", "vsplit", "only", "close", "wincmd h", "wincmd j", "wincmd k", "wincmd l"])
      .describe("Window manipulation command: split or vsplit to create new window, only to keep just current window, close to close current window, or wincmd with h/j/k/l to navigate between windows")
  },