Get the FREE Ultimate OpenClaw Setup Guide →

mcphub-lualine.nvim

Lualine component for MCPHub in Neovim

Installation
Run this command in your terminal to add the MCP server to Claude Code.
Run in terminal:
Command
claude mcp add --transport stdio franco-ruggeri-mcphub-lualine.nvim git clone https://github.com/franco-ruggeri/mcphub-lualine.nvim.git

How to use

mcphub-lualine.nvim is a lightweight Neovim component that displays real-time MCPHub status directly in your statusline. It subscribes to mcphub.nvim and shows either the number of active MCP servers or a spinner while mcphub.nvim is starting. The component is lazy-loading friendly: it only activates after mcphub.nvim has loaded, ensuring that your statusline remains performant. You can customize the icon and spinner symbols to fit your preferred aesthetic. To use it, add mcphub-lualine.nvim as a dependency of your lualine setup and include the 'mcphub' component in your lualine_x section; the plugin will render the MCPHub status automatically when mcphub.nvim becomes available.

How to install

Prerequisites:

  • Neovim (version compatible with mcphub and lualine)
  • A working Neovim plugin manager (examples: lazy.nvim, vim-plug, packer.nvim)
  • mcphub.nvim installed and configured in your Neovim setup

Installation steps (using lazy.nvim as in the README):

  1. Ensure lazy.nvim is installed and configured in your Neovim setup.
  2. Add mcphub-lualine.nvim as a dependency to your lazy.nvim configuration, alongside lualine.nvim, and ensure mcphub.nvim is loaded in your.nvim/lazy config order:
return {
  "nvim-lualine/lualine.nvim",
  dependencies = {
    "franco-ruggeri/mcphub-lualine.nvim",
    -- Other dependencies
  },
  opts = {
    sections = {
      lualine_x = {
        "mcphub",
        -- Other components
      },
    },
  },
}
  1. Sync/install plugins with your plugin manager (e.g., :LazySync for lazy.nvim).
  2. Restart Neovim and ensure mcphub.nvim is loaded before the lualine component activates (to preserve lazy loading).

Additional notes

Tips:

  • The lualine component activates only after mcphub.nvim is loaded; avoid listing mcphub.nvim as a dependency of lualine to preserve lazy loading behavior.
  • You can customize the component via lualine setup options, including icon and spinner_symbols, to match your UI preferences.
  • If you don’t see the MCPHub status immediately, ensure mcphub.nvim is properly configured and loaded before lualine.
  • This plugin is designed to be lightweight and play nicely with lazy-loading to prevent startup slowdowns.

Related MCP Servers

Sponsor this space

Reach thousands of developers