# 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 servers with your favorite chat plugins.

- **Type:** MCP server
- **Install:** `agentstack add mcp-ravitemer-mcphub-nvim`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ravitemer](https://agentstack.voostack.com/s/ravitemer)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ravitemer](https://github.com/ravitemer)
- **Source:** https://github.com/ravitemer/mcphub.nvim
- **Website:** https://ravitemer.github.io/mcphub.nvim/

## Install

```sh
agentstack add mcp-ravitemer-mcphub-nvim
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

Special thanks to:
   
   
   
      
   

### [The Intelligent Terminal](https://www.warp.dev/mcp-hub-nvim)

[Run mcphub.nvim in Warp today](https://www.warp.dev/mcp-hub-nvim)

  MCP HUB

[](https://www.lua.org)
[](https://nixos.org)
[](https://opensource.org/licenses/MIT)
[](https://discord.gg/NTqfxXsNuN)

MCP Hub is a MCP client for neovim that seamlessly integrates [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) 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**](https://modelcontextprotocol.io/specification/2025-03-26/server) ||||
| | 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](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http) | ✅ | Primary transport protocol for remote servers |
| | [SSE](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#backwards-compatibility) | ✅ | Fallback transport for remote servers |
| | [STDIO](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#stdio) | ✅ | For local servers |
| **Authentication for remote servers** ||||
| | [OAuth](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization) | ✅ | With PKCE flow |
| | Headers | ✅ | For API keys/tokens |
| **Chat Integration** ||||
| | [Avante.nvim](https://github.com/yetone/avante.nvim) | ✅ | Tools, resources, resourceTemplates, prompts(as slash_commands) |
| | [CodeCompanion.nvim](https://github.com/olimorris/codecompanion.nvim) | ✅ | Tools, resources, templates, prompts (as slash_commands), 🖼 image responses | 
| | [CopilotChat.nvim](https://github.com/CopilotC-Nvim/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`](https://github.com/Joakker/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](https://ravitemer.github.io/mcphub.nvim/) for detailed guides and examples

## 👋 Get Help

- Check out the [Troubleshooting guide](https://ravitemer.github.io/mcphub.nvim/troubleshooting)
- Join our [Discord server](https://discord.gg/NTqfxXsNuN) for discussions, help, and updates

## :gift: Contributing

Please read the [CONTRIBUTING.md](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](https://github.com/MunifTanjim/nui.nvim) for inspiring our text highlighting utilities
- [ravitemer/mcp-registry](https://github.com/ravitemer/mcp-registry) for providing the marketplace api

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ravitemer](https://github.com/ravitemer)
- **Source:** [ravitemer/mcphub.nvim](https://github.com/ravitemer/mcphub.nvim)
- **License:** MIT
- **Homepage:** https://ravitemer.github.io/mcphub.nvim/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-ravitemer-mcphub-nvim
- Seller: https://agentstack.voostack.com/s/ravitemer
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.