Sandbox
@ravitemer/mcphub.nvim

MCP client for Neovim chat plugins

MCP Hub connects Neovim chat plugins to MCP servers so you can browse, test, and use tools, resources, prompts, and templates from inside the editor. It supports local STDIO servers, remote HTTP and SSE servers, OAuth and header auth, and live updates when server lists change.

1,786 starsโ€ข93 forksโ€ขLuaโ€ขUpdated 8mo ago
Who it's for

Builders who use Neovim chat plugins and want MCP servers available inside their editor.

What it delivers

You can work with MCP servers from Neovim instead of switching between your editor and separate server tools.

What it does

Chat plugin integration

Works with Avante.nvim, CodeCompanion.nvim, and CopilotChat.nvim for tools, resources, prompts, templates, and function calling where supported.

MCP transport support

Handles Streamable HTTP, SSE, and STDIO transports for remote and local servers.

Remote auth support

Supports OAuth with PKCE and header-based auth for API keys and tokens.

Marketplace and discovery

Lets you browse verified MCP servers and install them manually or with AI help.

Workspace-aware config

Detects project-local configs and merges them with global settings.

Live server syncing

Watches config files, keeps multiple Neovim instances in sync, and supports hot reload in dev mode.

Lua-native servers

Lets you define MCP tools, resources, and prompts directly in Lua.

README


MCP HUB

Lua NixOS License: MIT Discord

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.

Image

๐Ÿ’œ Sponsors

CryogenicPlanet Oli Morris Super Memory yingmanwumen Yetone omarcresp petermoser watsy0007 kohane27 Kelly CopleyNom Social

Special thanks to:

Composio.dev logo Vapi logo

โœจ Features

CategoryFeatureSupportDetails
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

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

Files in the repo

Repository payloadโ€ข21 top-level entries
  • .github
  • .mcphub
  • doc
  • lua
  • plugin
  • scripts
  • tests
  • .gitignore
  • .luarc.json
  • bundled_build.lua
  • CHANGELOG.md
  • CODE_OF_CONDUCT.md
  • CONTRIBUTING.md
  • flake.lock
  • flake.nix
  • LICENSE.md
  • Makefile
  • README.md
  • SECURITY.md
  • selene.toml
  • stylua.toml

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More connectors

High-performance code intelligence MCP server. Indexes codebases into a persistent knowledge graph โ€” average repo in milliseconds. 158 languages, sub-ms queries, 99% fewer tokens. Single static binary, zero dependencies.

43k

Universal provider proxy for OpenAI Codex & Claude Code โ€” use any LLM (Claude, Gemini, Grok, DeepSeek, Ollamaโ€ฆ) with Codex CLI, App, SDK, and Claude Code

14k
okf-memory/
okf-agent-memory

Git-native persistent memory for AI coding agents. Implements Google OKF v0.2 with sub-300ยตs in-memory BM25 search, embedded MCP server, and progressive disclosure. Slashes token bloat by 80% with zero external databases or dependencies. Built in pure Go.

547
tirth8205/
code-review-graph

Local-first code intelligence graph for MCP and CLI. Builds a persistent map of your codebase so AI coding tools read only what matters, with benchmarked context reductions on reviews and large-repo workflows.

31k
2akouwu/
reverify

Stop your AI from making things up โ€” it proposes, deterministic tools decide, every claim checked against ground truth with evidence. Grounded facts and context survive resets. Reverse engineering is the proving ground. MCP server + CLI.

1.1k
t8y2/dbxConnectors

20 MB lightweight cross-platform database client for 90+ databases, including MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, SQL Server, and Dameng. Built-in AI, MCP Server, CLI, desktop and Docker. | ่ฝป้‡็บง่ทจๅนณๅฐๆ•ฐๆฎๅบ“็ฎก็†ๅทฅๅ…ท๏ผŒๆ”ฏๆŒ MySQLใ€PostgreSQLใ€SQLiteใ€Redisใ€MongoDBใ€่พพๆขฆ็ญ‰ 90+ ๆ•ฐๆฎๅบ“๏ผŒๆไพ›ๆกŒ้ข็ซฏใ€Dockerใ€CLIใ€ๅ†…็ฝฎ AI ๅŠฉๆ‰‹ๅ’Œ MCP Serverใ€‚

19k