ravitemer/mcphub.nvim
An MCP client for Neovim that seamlessly integrates MCP servers into your editing workflow with an intuitive interface for managing, testing, and using MCP servers with your favorite chat plugins.
1,783 ★87 forksLuaUpdated 6mo ago
What you need to know
An MCP client for Neovim that integrates MCP servers into the editing workflow and provides an intuitive interface for managing, testing, and using MCP servers with chat plugins such as Avante, CodeCompanion, and CopilotChat.
Install
Requires the mcp-hub server (npm install -g mcp-hub); install the plugin via your Neovim package manager or lazy.nvim (source "ravitemer/mcphub.nvim").
Nix flake: add mcp-hub.url = "github:ravitemer/mcp-hub" to inputs and input.mcp-hub.packages."${system}".default to system packages.Usage
- •Call require("mcphub").setup({ port = 3000, config = "path/to/mcp-servers.json" }) in your Neovim config.
- •Execute MCP tools, access resources, and use prompts (as slash commands) directly from chat plugins (avante.nvim, codecompanion.nvim, copilotchat.nvim).
- •Use the marketplace to discover and auto-install MCP servers, including AI-assisted installation.
- •Write Lua-native MCP servers (tools, resources, prompts) directly in Lua; use dev mode for hot-reload of servers on file changes.
Key features
- ✓Full capability support: tools, resources, resource templates, prompts, and real-time list-changed notifications.
- ✓Remote transports: streamable-http (primary), SSE (fallback), STDIO (local), with OAuth PKCE and header auth for remote servers.
- ✓Chat integration: Avante.nvim, CodeCompanion.nvim (including image responses), CopilotChat.nvim (function calling).
- ✓Workspace management: project-local configs auto-detected and merged with global config; multi-instance sync across Neovim instances; shutdown-delay for systemd service use.
- ✓VS Code mcp.json compatibility and universal ${} placeholder syntax.
Best for
Neovim users who want to manage and use MCP servers from inside the editor with AI chat plugins (Avante / CodeCompanion / CopilotChat).
Caveats
- ⚠MCP Roots and Sampling capabilities are not supported.
- ⚠Requires the mcp-hub server binary running; primarily targets Linux/macOS (Nix support built in).
Platforms: macOS · LinuxClients: Neovim · Avante.nvim · CodeCompanion.nvim · CopilotChat.nvim
Documentation ↗Reviewed 2026-08-07
Topics
avantechatgptchatpluginclaude-aicodecompanionllmmcpmcp-clientmcp-hubmcp-servermcp-serversmodel-context-protocolneovimneovim-pluginnvimnvim-plugin
- Stars
- 1,783★
- Forks
- 87
- Language
- Lua
- License
- MIT
- Created
- 2025-02-19
- Last push
- 2026-01-18