The Intelligent Terminal
Run mcphub.nvim in Warp today<br>
</div> <hr> <div align="center" markdown="1"> <h1> <img width="28px" style="display:inline;" src="https://github.com/user-attachments/assets/5cdf9d69-3de7-458b-a670-5153a97c544a"/> MCP HUB</h1>
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
<!-- sponsors --> <p align="center"> <a href="https://github.com/CryogenicPlanet"><img src="https://github.com/CryogenicPlanet.png" width="50px" alt="CryogenicPlanet" /></a> <a href="https://github.com/olimorris"><img src="https://github.com/olimorris.png" width="50px" alt="Oli Morris" /></a> <a href="https://github.com/supermemoryai"><img src="https://github.com/supermemoryai.png" width="50px" alt="Super Memory" /></a> <a href="https://github.com/yingmanwumen"><img src="https://github.com/yingmanwumen.png" width="50px" alt="yingmanwumen" /></a> <a href="https://github.com/yetone"><img src="https://github.com/yetone.png" width="50px" alt="Yetone" /></a> <a href="https://github.com/omarcresp"><img src="https://github.com/omarcresp.png" width="50px" alt="omarcresp" /></a> <a href="https://github.com/petermoser"><img src="https://github.com/petermoser.png" width="50px" alt="petermoser" /></a> <a href="https://github.com/watsy0007"><img src="https://github.com/watsy0007.png" width="50px" alt="watsy0007" /></a> <a href="https://github.com/kohane27"><img src="https://github.com/kohane27.png" width="50px" alt="kohane27" /></a> <a href="https://github.com/copleykj"><img src="https://github.com/copleykj.png" width="50px" alt="Kelly Copley" /></a><a href="https://github.com/nom-social"><img src="https://github.com/nom-social.png" width="50px" alt="Nom Social" /></a></p><!-- sponsors --> <p align="center"> <b>Special thanks to:</b> </p> <p align="center"> <a href="https://dub.sh/composio-mcp" target="_blank"> <img src="https://ravitemer.github.io/mcphub.nvim/sponsors/composio-logo.png" height="60px" alt="Composio.dev logo" /> </a> <a href="https://vapi.ai" target="_blank"> <img src="https://github.com/user-attachments/assets/32b4d458-b2d1-484d-b096-dfb083b44c2c" height="60px" alt="Vapi logo" /></a> </p>✨ 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 slash_commands) | |
| CodeCompanion.nvim | ✅ | Tools, resources, templates, prompts (as slash_commands), 🖼 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
<div align="center"> <h4>MCP Hub + <a href="https://github.com/olimorris/codecompanion.nvim">CodeCompanion</a> + Github </h4> <p> <video muted controls src="https://github.com/user-attachments/assets/1a10ad50-5832-4627-bcc3-be49e7941105"></video> </p> </div> <div align="center"> <p> <h4>MCP Hub + <a href="https://github.com/yetone/avante.nvim">Avante</a> + Figma </h4> <video controls muted src="https://github.com/user-attachments/assets/e33fb5c3-7dbd-40b2-bec5-471a465c7f4d"></video> </p> </div>🚀 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 guide.
🚧 TODO
- Neovim MCP Server (kind of) with better editing, diffs, terminal integration etc (Ideas are welcome)
- Enhanced help view with comprehensive documentation
- MCP Resources as variables in chat plugins
- MCP Prompts as slash commands in chat plugins
- Enable LLM to start and stop MCP Servers dynamically
- Support SSE transport
- Support /slash_commands in avante
- Support streamable-http transport
- Support OAuth
- Add types
- 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