Mcphub Nvim

Special thanks to:

The Intelligent Terminal

Run mcphub.nvim in Warp today

MCP HUB

[](https://www.lua.org) [](https://nixos.org) [](https://opensource.org/licenses/MIT) [](https://discord.gg/NTqfxXsNuN)

MCP Hub is a MCP client for neovim that seamlessly integrates MCP (Model Context Protocol) servers into your editing workflow. It provides an intuitive interface for managing, testing, and using MCP servers with your favorite chat plugins.

💜 Sponsors

Special thanks to:

✨ Features

| Category | Feature | Support | Details | |----------|---------|---------|-------| | Capabilities |||| | | Tools | ✅ | Full support | | | 🔔 Tool List Changed | ✅ | Real-time updates | | | Resources | ✅ | Full support | | | 🔔 Resource List Changed | ✅ | Real-time updates | | | Resource Templates | ✅ | URI templates | | | Prompts | ✅ | Full support | | | 🔔 Prompts List Changed | ✅ | Real-time updates | | | Roots | ❌ | Not supported | | | Sampling | ❌ | Not supported | | MCP Server Transports |||| | | Streamable-HTTP | ✅ | Primary transport protocol for remote servers | | | SSE | ✅ | Fallback transport for remote servers | | | STDIO | ✅ | For local servers | | Authentication for remote servers |||| | | OAuth | ✅ | With PKCE flow | | | Headers | ✅ | For API keys/tokens | | Chat Integration |||| | | Avante.nvim | ✅ | Tools, resources, resourceTemplates, prompts(as slashcommands) | | | CodeCompanion.nvim | ✅ | Tools, resources, templates, prompts (as slashcommands), 🖼 image responses | | | CopilotChat.nvim | ✅ | Tools, resources, function calling support | | Marketplace |||| | | Server Discovery | ✅ | Browse from verified MCP servers | | | Installation | ✅ | Manual and auto install with AI | | Configuration |||| | | Universal ${} Syntax | ✅ | Environment variables and command execution across all fields | | | VS Code Compatibility | ✅ | Support for servers key, ${env:}, ${input:}, predefined variables | | | JSON5 Support | ✅ | Comments and trailing commas via lua-json5 | | Workspace Management |||| | | Project-Local Configs | ✅ | Automatic detection and merging with global config | | Advanced |||| | | Smart File-watching | ✅ | Smart updates with config file watching | | | Multi-instance | ✅ | All neovim instances stay in sync | | | Shutdown-delay | ✅ | Can run as systemd service with configure delay before stopping the hub | | | Lua Native MCP Servers | ✅ | Write once , use everywhere. Can write tools, resources, prompts directly in lua | | | Dev Mode | ✅ | Hot reload MCP servers on file changes for development |

🎥 Demos

MCP Hub + CodeCompanion + Github

MCP Hub + Avante + Figma

🚀 Getting Started

Visit our documentation site for detailed guides and examples

👋 Get Help

• Check out the Troubleshooting guide
• Join our Discord server for discussions, help, and updates

:gift: Contributing

Please read the [CONTRIBUTING.md](CONTRIBUTING.md) guide.

🚧 TODO

• [x] Neovim MCP Server (kind of) with better editing, diffs, terminal integration etc (Ideas are welcome)
• [x] Enhanced help view with comprehensive documentation
• [x] MCP Resources as variables in chat plugins
• [x] MCP Prompts as slash commands in chat plugins
• [x] Enable LLM to start and stop MCP Servers dynamically
• [x] Support SSE transport
• [x] Support /slash_commands in avante
• [x] Support streamable-http transport
• [x] Support OAuth
• [x] Add types
• [x] Better Docs
• [ ] Add tests
• [ ] Support #variables in avante

👏 Acknowledgements

Thanks to:

• nui.nvim for inspiring our text highlighting utilities
• ravitemer/mcp-registry for providing the marketplace api

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: ravitemer
• Source: ravitemer/mcphub.nvim
• License: MIT
• Homepage: https://ravitemer.github.io/mcphub.nvim/

Install and usage instructions live in the source repository linked above.