This Neovim plugin provides a centralized hub for Model Context Protocol (MCP) servers, enabling seamless integration of LLM tools and resources into the Neovim editing workflow. It targets developers and power users seeking to leverage LLMs for code generation, analysis, and interaction within their IDE, offering a unified interface for managing, discovering, and utilizing diverse MCP capabilities.

How It Works

MCPHub.nvim utilizes an Express.js server to manage MCP server configurations and client requests. Upon setup, it ensures the mcp-hub CLI is installed and running, establishing an Express server for communication. This server handles real-time configuration watching, server lifecycle management, and client registration, supporting multiple Neovim instances. It exposes a REST API for plugins to interact with registered MCP servers, facilitating tool execution and resource access.

Quick Start & Requirements

• Install: Use lazy.nvim with build = "npm install -g mcp-hub@latest".
• Prerequisites: Neovim >= 0.8.0, Node.js >= 18.0.0, plenary.nvim, mcp-hub (auto-installed).
• Docs: Installation Guide, Configuration Guide.

Highlighted Details

• Native MCP Servers: Create Lua-based MCP servers directly within Neovim, supporting tools, resources, and prompts with a unified API.
• Chat Plugin Integration: Deep integration with Avante.nvim and CodeCompanion.nvim, exposing MCP tools as chat commands/variables and prompts as slash commands.
• Marketplace: Browse, discover, and install community MCP servers directly from within Neovim.
• Multi-instance Support: All Neovim instances stay synchronized with a configurable shutdown delay for the hub server.

Maintenance & Community

• Discord: Join for discussions, help, and updates.
• Roadmap: Features include type support, tests, and enhanced documentation.

Licensing & Compatibility

• License: Not explicitly stated in the README, but typically Neovim plugins are MIT or similar permissive licenses. Compatibility for commercial use is likely, but requires verification.

Limitations & Caveats

• Native MCP Server documentation is marked as beta.
• Some features like #variables in Avante.nvim are still under development.
• Potential tool conflicts with built-in chat plugin features require manual configuration.