MCP Hub
by
Integrates Model Context Protocol servers into Neovim, offering an intuitive UI for managing, testing, and using them with popular chat plugins.
MCP Hub Overview
What is MCP Hub about?
MCP Hub brings Model Context Protocol servers directly into the Neovim editing experience. It acts as a bridge between local or remote MCP servers and chat‑oriented extensions such as Avante.nvim, CodeCompanion.nvim, and CopilotChat.nvim, allowing developers to invoke tools, resources, and prompts without leaving the editor.
How to use MCP Hub?
- Install the plugin using your preferred Neovim plugin manager (e.g.,
lazy.nvim,packer). - Configure servers in a
servers.jsonor Lua table – the plugin supports JSON5, environment variable interpolation (${}), and VS Code‑style configuration. - Launch the hub with the provided command (e.g.,
:McpHubStart). The hub will start configured local servers via STDIO or connect to remote ones via Streamable‑HTTP/SSE. - Interact through chat plugins – tools appear as slash commands, resources become insertable variables, and image responses are shown where supported.
Key Features of MCP Hub
- Full support for MCP capabilities: tools, resources, resource templates, prompts, and real‑time list change notifications.
- Multiple transport layers: Streamable‑HTTP (primary), SSE (fallback), and STDIO for local servers.
- Authentication via OAuth (PKCE) and custom headers for API keys.
- Seamless integration with Avante.nvim, CodeCompanion.nvim, and CopilotChat.nvim, exposing tools, resources, and prompts 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 configuration fields. - JSON5 support, VS Code compatibility, project‑local config detection, smart file‑watching, multi‑instance sync, and optional shutdown delay for systemd services.
- Development mode with hot‑reload of Lua‑based MCP servers.
Use Cases of MCP Hub
- Tooling within code – invoke linters, formatters, or custom scripts from a chat window.
- Context‑aware code generation – fetch prompts/templates from a server and feed them to LLMs via chat plugins.
- Resource sharing – expose project files, secrets, or API endpoints as resources that LLMs can query safely.
- Rapid prototyping – develop and test new MCP servers locally using the built‑in STDIO transport and hot‑reload.
- Team-wide AI assistance – share a common server configuration across multiple Neovim instances, keeping AI behavior consistent.
FAQ from MCP Hub
Q: Do I need a specific version of Neovim?
A: The plugin requires Neovim 0.9 or newer because it relies on LuaJIT and the built‑in vim.ui APIs.
Q: Can I run a server locally without internet? A: Yes, use the STDIO transport. Define a Lua‑based server or an executable that communicates over standard input/output.
Q: How does authentication work for remote servers? A: The hub supports OAuth with PKCE flow and arbitrary header injection, which you can configure in the server definition.
Q: What chat plugins are supported? A: Avante.nvim, CodeCompanion.nvim, and CopilotChat.nvim are officially supported, but any plugin that accepts slash commands or function calls can be integrated.
Q: Where can I find more documentation? A: Detailed guides, troubleshooting steps, and API references are hosted at https://ravitemer.github.io/mcphub.nvim/.
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
- 2 months ago
Related MCP Servers
Discover more MCP servers with similar functionality and use cases
Zed
OfficialClientby zed-industries
Provides real-time collaborative editing powered by Rust, enabling developers to edit code instantly across machines with a responsive, GPU-accelerated UI.
Cline
Clientby cline
Provides autonomous coding assistance directly in the IDE, enabling file creation, editing, terminal command execution, browser interactions, and tool extension with user approval at each step.
Continue
Clientby continuedev
Provides continuous AI assistance across IDEs, terminals, and CI pipelines, offering agents, chat, inline editing, and autocomplete to accelerate software development.
GitHub MCP Server
by github
Enables AI agents, assistants, and chatbots to interact with GitHub via natural‑language commands, providing read‑write access to repositories, issues, pull requests, workflows, security data and team activity.
Goose
Clientby block
Automates engineering tasks by installing, executing, editing, and testing code using any large language model, providing end‑to‑end project building, debugging, workflow orchestration, and external API interaction.
Roo Code
OfficialClientby RooCodeInc
An autonomous coding agent that lives inside VS Code, capable of generating, refactoring, debugging code, managing files, running terminal commands, controlling a browser, and adapting its behavior through custom modes and instructions.
Mcp Agent
Clientby lastmile-ai
A lightweight, composable framework for building AI agents using Model Context Protocol and simple workflow patterns.
Firebase CLI
by firebase
Provides a command‑line interface to manage, test, and deploy Firebase projects, covering hosting, databases, authentication, cloud functions, extensions, and CI/CD workflows.
Gptme
Clientby gptme
Empowers large language models to act as personal AI assistants directly inside the terminal, providing capabilities such as code execution, file manipulation, web browsing, vision, and interactive tool usage.