mcphub.nvim

<div align="center" markdown="1"> ^{Special thanks to:} <br> <br> <a href="https://www.warp.dev/mcp-hub-nvim"> <img alt="Warp sponsorship" src="https://github.com/user-attachments/assets/fae9c70d-51de-43fa-af65-c82228ba67f9"> </a> ### [The Intelligent Terminal](https://www.warp.dev/mcp-hub-nvim) [Run mcphub.nvim in Warp today](https://www.warp.dev/mcp-hub-nvim)<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> [](https://www.lua.org) [](https://nixos.org) [](https://opensource.org/licenses/MIT) [](https://discord.gg/NTqfxXsNuN) </div> MCP Hub is a MCP client for neovim that seamlessly integrates [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) 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**](https://modelcontextprotocol.io/specification/2025-03-26/server) |||| | | 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](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http) | ✅ | Primary transport protocol for remote servers | | | [SSE](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#backwards-compatibility) | ✅ | Fallback transport for remote servers | | | [STDIO](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#stdio) | ✅ | For local servers | | **Authentication for remote servers** |||| | | [OAuth](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization) | ✅ | With PKCE flow | | | Headers | ✅ | For API keys/tokens | | **Chat Integration** |||| | | [Avante.nvim](https://github.com/yetone/avante.nvim) | ✅ | Tools, resources, resourceTemplates, prompts(as slash_commands) | | | [CodeCompanion.nvim](https://github.com/olimorris/codecompanion.nvim) | ✅ | Tools, resources, templates, prompts (as slash_commands), 🖼 image responses | | | [CopilotChat.nvim](https://github.com/CopilotC-Nvim/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`](https://github.com/Joakker/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](https://ravitemer.github.io/mcphub.nvim/) for detailed guides and examples ## 👋 Get Help - Check out the [Troubleshooting guide](https://ravitemer.github.io/mcphub.nvim/troubleshooting) - Join our [Discord server](https://discord.gg/NTqfxXsNuN) 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](https://github.com/MunifTanjim/nui.nvim) for inspiring our text highlighting utilities - [ravitemer/mcp-registry](https://github.com/ravitemer/mcp-registry) for providing the marketplace api