mcphub.nvim

Manages both local STDIO-based MCP servers and remote HTTP/SSE servers through a central MCPHub.Hub class that orchestrates an external Node.js service (mcp-hub) while maintaining Lua-native server support. Implements asynchronous communication channels with real-time state synchronization across multiple Neovim instances, handling server startup, shutdown, and health monitoring through a multi-process architecture with clear separation between the Neovim plugin layer and external service management.

Transforms MCP capabilities (tools, resources, prompts) into plugin-specific access patterns optimized for Avante.nvim, CodeCompanion.nvim, and CopilotChat.nvim through an extension system that adapts MCP semantics to each plugin's native function-calling and context-injection APIs. Implements sophisticated auto-approval mechanisms configurable globally, per-server, or through custom functions, enabling seamless tool invocation within chat workflows without manual approval overhead.

Implements multi-level auto-approval rules (global, per-server, per-tool, or custom function-based) that determine whether tool invocations require manual confirmation or execute automatically. Supports different approval strategies per chat plugin (function-based for Avante, real-time for CodeCompanion, global for CopilotChat) with audit logging of approval decisions.

Validates strict version compatibility between mcphub.nvim plugin (5.13.0+), mcp-hub Node.js service (4.1.0+), and MCP servers to ensure reliable operation across the distributed architecture. Implements version checking at startup and before critical operations, with clear error messages guiding users to compatible versions.

Implements non-blocking asynchronous communication channels between Neovim and the external mcp-hub Node.js service using event-driven patterns, preventing editor freezing during server operations. Handles concurrent requests, response buffering, and timeout management to ensure responsive UI even during long-running MCP operations.

Enables writing MCP servers directly in Lua that run within the Neovim process without external dependencies, eliminating inter-process communication overhead for local tools. Provides Lua APIs for defining tools and resources that conform to MCP specification, with automatic registration into the MCP ecosystem and exposure to chat plugins through the same integration system as external servers.

Provides a browsable marketplace interface within Neovim for discovering, previewing, and installing pre-configured MCP servers with one-command setup. Integrates with a centralized MCP server registry, handling dependency resolution, configuration templating, and version management to reduce friction in onboarding new servers into the local MCP ecosystem.

Maintains synchronized MCP server state across multiple Neovim instances through event-driven communication channels, ensuring that server lifecycle changes (start/stop), configuration updates, and tool availability are immediately reflected across all connected editors. Implements asynchronous event propagation with conflict resolution for concurrent state modifications.

Provides a slash command syntax (/mcp:*) within chat plugins (Avante, CodeCompanion) for explicit MCP tool invocation with inline argument specification, enabling users to trigger specific tools without relying on AI model decision-making. Implements command parsing, argument validation against tool schemas, and result formatting for seamless integration into chat conversations.

Manages MCP server configurations through a declarative system supporting TOML/JSON formats with environment variable interpolation, allowing users to define server startup commands, arguments, and authentication credentials without hardcoding sensitive values. Implements configuration validation, version compatibility checking, and schema enforcement to prevent misconfiguration.

Exposes MCP resources (text/binary content identified by URIs) to chat plugins through a resource access layer that handles content fetching, caching, and format conversion. Implements URI pattern matching for resource discovery and lazy-loading to avoid fetching unnecessary content, with support for both static and dynamic resource generation from MCP servers.

Exposes MCP prompt templates as system context or conversation starters within chat plugins, enabling MCP servers to provide domain-specific prompting strategies. Implements prompt variable substitution and formatting to adapt generic prompts to specific contexts, with support for multi-turn conversation templates.

Provides a Neovim-native UI (using Lua-based components) for browsing, configuring, starting/stopping servers, and testing tools interactively. Implements a main view showing server status, a marketplace view for discovery, and tool testing panels that allow users to invoke tools with custom arguments and inspect results without leaving the editor.