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

👏 Acknowledgements

Thanks to:

nui.nvim for inspiring our text highlighting utilities
ravitemer/mcp-registry for providing the marketplace api

mcphub.nvim