Mcp Hub
by
Integrates Model Context Protocol servers into Neovim, offering an intuitive UI for managing, testing, and using those servers with popular chat plugins.
Mcp Hub Overview
What is Mcp Hub about?
Mcp Hub brings Model Context Protocol (MCP) server capabilities directly into the Neovim editing experience. It acts as a bridge between MCP services—such as tools, resources, prompts, and image generation—and chat‑oriented plugins like Avante.nvim, CodeCompanion.nvim, and CopilotChat.nvim.
How to use Mcp Hub?
- Install the plugin via your preferred Neovim plugin manager (e.g.,
lazy.nvim,packer.nvim). - Open the MCP Hub UI (
:McpHub) to discover available MCP servers from the built‑in marketplace. - Add or edit server definitions in the configuration files (global or project‑local). The plugin automatically merges them and watches for changes.
- Select a server and invoke its capabilities from your chat plugin using slash commands, tool menus, or function‑calling interfaces.
- Optionally, configure authentication (OAuth PKCE or header tokens) and choose the transport (Streamable‑HTTP, SSE, STDIO).
Key Features of Mcp Hub
- Full support for MCP capabilities: tools, resources, resource templates, prompts, and real‑time change notifications.
- Multiple transport protocols: Streamable‑HTTP (primary), SSE (fallback), and STDIO for local servers.
- Authentication via OAuth PKCE flow or custom headers.
- Seamless integration with Avante.nvim, CodeCompanion.nvim, and CopilotChat.nvim, exposing MCP features as slash commands or function calls.
- Marketplace for discovering verified MCP servers, with one‑click install and AI‑assisted setup.
- Universal
${}syntax for environment variables and command execution across all config fields. - JSON5 configuration support, VS Code‑compatible
serverskey, and smart file‑watching for live reloads. - Multi‑instance synchronization, shutdown‑delay for systemd services, and a native Lua server mode for custom MCP implementations.
Use Cases of Mcp Hub
- Tool orchestration: Run external utilities (e.g., linters, formatters) from within a chat conversation.
- Resource retrieval: Pull snippets, documentation, or API schemas directly into the editor.
- Prompt engineering: Expose custom prompts as slash commands for quick access.
- Image generation: Receive and display generated images inside Neovim via CodeCompanion.
- Dynamic server management: Start/stop MCP servers on demand from the hub UI.
FAQ
Q: Which chat plugins are supported? A: Avante.nvim, CodeCompanion.nvim, and CopilotChat.nvim are fully supported, with plans to add more.
Q: How do I add a new MCP server?
A: Add a JSON5 entry under the servers key in either the global mcphub.lua or a project‑local config file; the hub will auto‑detect it.
Q: Can I run a local MCP server written in Lua? A: Yes, Mcp Hub can load Lua‑based MCP servers directly, enabling fast development with hot‑reload (Dev Mode).
Q: What authentication methods are available? A: OAuth with PKCE flow and custom header tokens for API keys.
Q: Is there a way to watch for server changes? A: The hub includes a smart file‑watcher that reloads configurations and synchronizes across all Neovim instances.
Mcp Hub's README
The Intelligent Terminal
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
✨ 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
🚀 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
Mcp Hub Reviews
Login Required
Please log in to share your review and rating for this MCP.
Actions
Mcp Hub's Information
- Author
- ravitemer
- Category
- Development Tools
- Language
- Lua
- License
- MIT License
- Stars
- 1,453
- Updated
- 15 days ago
Similar MCP Servers like Mcp Hub
Explore related MCPs that share similar capabilities and solve comparable challenges
Zed
OfficialClientby zed-industries
A high‑performance, multiplayer code editor designed for speed and collaboration.
Everything
Officialby modelcontextprotocol
Model Context Protocol Servers
Git
Officialby modelcontextprotocol
A Model Context Protocol server for Git repository interaction and automation.
Time
Officialby modelcontextprotocol
A Model Context Protocol server that provides time and timezone conversion capabilities.
Cline
OfficialClientby cline
An autonomous coding assistant that can create and edit files, execute terminal commands, and interact with a browser directly from your IDE, operating step‑by‑step with explicit user permission.
Continue
OfficialClientby continuedev
Enables faster shipping of code by integrating continuous AI agents across IDEs, terminals, and CI pipelines, offering chat, edit, autocomplete, and customizable agent workflows.
Context7 MCP
Officialby upstash
Provides up-to-date, version‑specific library documentation and code examples directly inside LLM prompts, eliminating outdated information and hallucinated APIs.
Framelink Figma MCP Server
by GLips
Provides Figma layout and styling information to AI coding agents, enabling one‑shot implementation of designs in any framework.
GitMCP
by idosal
Provides a remote Model Context Protocol server that transforms any public GitHub repository into an up‑to‑date documentation hub, enabling AI assistants to fetch live code and docs, dramatically reducing hallucinations.