mcphub.nvim

An MCP client for Neovim that seamlessly integrates MCP servers into your editing workflow with an intuitive interface for managing, testing, and using MCP s...

1,606 stars LuaAI & Machine Learning Updated Nov 4, 2025

avantechatgptchatpluginclaude-aicodecompanionllmmcpmcp-clientmcp-hubmcp-servermcp-serversmodel-context-protocolneovimneovim-pluginnvimnvim-plugin

Documentation

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
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

[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 for inspiring our text highlighting utilities
ravitemer/mcp-registry for providing the marketplace api

Frequently asked questions

What is mcphub.nvim?

mcphub.nvim is An MCP client for Neovim that seamlessly integrates MCP servers into your editing workflow with an intuitive interface for managing, testing, and using MCP s...

How do I install mcphub.nvim?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is mcphub.nvim open source?

Yes — it is hosted on GitHub at https://github.com/ravitemer/mcphub.nvim and has 1,606 stars.

Related MCP tools

mcp-router

A Unified MCP Server Management App TypeScript-based implementation. Trusted by 800+ developers. Trusted by 800+ developers.

846 TypeScript

llmllmopsmcp+7

jadx-ai-mcp

Plugin for JADX to integrate MCP server Java-based implementation. Trusted by 600+ developers. Trusted by 600+ developers.

613 Java

aijavallm+10

mcp-client-for-ollama

A text-based user interface (TUI) client for interacting with MCP servers using Ollama. Features include multi-server, dynamic model switching, streaming res...

351 Python

aicommand-line-toolgenerative-ai+17