mcphub.nvim logo

mcphub.nvim

by ravitemer

A powerful Neovim plugin that integrates MCP (Model Context Protocol) servers into your workflow. It offers a centralized config file, an intuitive UI, programmatic API access, and interactive testing capabilities.

View on GitHub

Last updated: N/A

What is mcphub.nvim?

MCPHub.nvim is a Neovim plugin that simplifies the integration and management of MCP (Model Context Protocol) servers. It provides a centralized interface for configuring, managing, and testing tools and resources from these servers, making it ideal for LLM-based workflows within Neovim.

How to use mcphub.nvim?

Install the plugin using a Neovim package manager like lazy.nvim. Configure the plugin with the path to your MCP server configuration file and the port for the Express server. Use the :MCPHub command to open the UI and manage servers, tools, and resources. Programmatically access MCP tools and resources using the provided Lua API.

Key features of mcphub.nvim

  • Simple single-command interface (:MCPHub)

  • Integrated Hub view for managing servers and tools

  • Marketplace Integration for browsing and installing servers

  • Interactive Testing for real-time tool evaluation

  • Developer-friendly API for tool and resource access

  • Integrates with CodeCompanion and Avante

Use cases of mcphub.nvim

  • Integrating LLMs into your Neovim workflow

  • Managing and testing various MCP tools

  • Accessing resources provided by MCP servers

  • Building custom Neovim chat interfaces powered by MCP

  • Enhacing tool accessibility within chat interfaces

FAQ from mcphub.nvim

What is MCP?

MCP stands for Model Context Protocol. It's a protocol that allows LLMs to securely access external tools and information.

What are the requirements for using mcphub.nvim?

Neovim >= 0.8.0, Node.js >= 18.0.0, plenary.nvim, and mcp-hub.

How do I configure MCP servers?

Create a JSON configuration file that lists your MCP servers with their commands, arguments, and environment variables. Specify the path to this file in the mcphub.nvim setup function.

How can I test if my MCP servers are working?

Use the MCP Inspector or mcp-cli to validate server functionality. The MCPHub UI's Logs view can also help you debug server issues.

I'm getting an error. Where can I get help?

First, test with minimal.lua file. Then, open an issue on the GitHub repository or start a discussion.