mcphub.nvim
ravitemer · ravitemer/mcphub.nvim
Integrates MCP servers into the Neovim editing workflow as an MCP client, allowing users to manage, test, and use MCP servers with chat plugins.
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.
Preview
What you can do with it
- Call an MCP tool from within Neovim to interact with an AI agent for code generation or refactoring.
- Test new MCP server capabilities or tools directly from your editor.
- Use your chat plugin to leverage MCP resources and prompts for context-aware coding assistance.
Safety check
No risky patterns found in the files we scanned.
Automated scan of the repo files. Always review code you run.
From the README
Special thanks to:
The Intelligent Terminal
MCP HUB
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 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
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 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