mcphub.nvim

---

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

🚀 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