MCPHub.nvim MCP Setup: Connect MCP Servers to MCPHub.nvim

What it is

A Neovim plugin that manages, tests, and uses MCP servers from inside the editor and wires them into chat plugins like Avante and CodeCompanion.

How MCP works in MCPHub.nvim

MCPHub.nvim is an MCP client for Neovim. It manages servers from a JSON file (editable via its UI) and supports both the mcpServers and VS Code servers formats.

Config file location

~/.config/mcphub/servers.json holds an mcpServers object; you can also manage servers from the plugin's UI instead of editing it by hand.

Add your first server

A good first server is Playwright MCP — Microsoft's browser automation server. It runs locally over stdio via npx, needs no API key, and gives the agent a real browser to drive. Here is the verified MCPHub.nvim config:

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest"]
    }
  }
}

Restart or reload MCPHub.nvim after saving, then confirm the server's tools show up. Swap in any other server from the directory using the same structure.

Transports & platforms

FAQ