/ Каталог / Песочница / mcphub.nvim
● Сообщество ravitemer ⚡ Сразу

mcphub.nvim

автор ravitemer · ravitemer/mcphub.nvim

Neovim plugin that turns your editor into a first-class MCP client — marketplace installs, Avante/CodeCompanion integration, OAuth PKCE.

ravitemer/mcphub.nvim integrates MCP servers into Neovim workflows. Discover + install via a verified marketplace, chat through Avante/CodeCompanion/CopilotChat, manage OAuth, hot-reload dev servers. Supports stdio, SSE, and Streamable HTTP.

Зачем использовать

Ключевые функции

Живое демо

Как выглядит на практике

mcphub-nvim.replay ▶ готово
0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "mcphub-nvim": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/ravitemer/mcphub.nvim"
      ],
      "_inferred": true
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "mcphub-nvim": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/ravitemer/mcphub.nvim"
      ],
      "_inferred": true
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "mcphub-nvim": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/ravitemer/mcphub.nvim"
      ],
      "_inferred": true
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "mcphub-nvim": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/ravitemer/mcphub.nvim"
      ],
      "_inferred": true
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "mcphub-nvim",
      "command": "TODO",
      "args": [
        "See README: https://github.com/ravitemer/mcphub.nvim"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json
{
  "context_servers": {
    "mcphub-nvim": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/ravitemer/mcphub.nvim"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add mcphub-nvim -- TODO 'See README: https://github.com/ravitemer/mcphub.nvim'

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: mcphub.nvim

How to use MCP servers from Neovim via Avante or CodeCompanion

👤 Neovim devs ⏱ ~20 min intermediate

Когда использовать: You live in Neovim and don't want to switch to VS Code for MCP access.

Предварительные требования
  • Neovim 0.10+ — brew install neovim
  • Avante.nvim or CodeCompanion.nvim installed — Via your plugin manager (lazy.nvim/packer)
  • mcphub.nvim + its Node dependency — See ravitemer.github.io/mcphub.nvim for install snippet
Поток
  1. Install via plugin manager
    Add ravitemer/mcphub.nvim to your lazy.nvim config with opts = { ... }.✓ Скопировано
    → :MCPHub opens the management UI
  2. Install a server from the marketplace
    :MCPHub marketplace — search 'github' and install.✓ Скопировано
    → Server starts, tools registered
  3. Use via Avante
    In Avante chat, ask a question — Avante picks up MCP tools.✓ Скопировано
    → Tool calls visible in Avante output

Итог: MCP tools usable inside your editor, no context switch.

Подводные камни
  • Node not on PATH inside Neovim — Use an absolute path in config or ensure Neovim inherits your shell env

How to set up project-local MCP servers that merge with global

👤 Polyglot devs with different tooling per project ⏱ ~15 min intermediate

Когда использовать: One project needs postgres MCP, another needs a bespoke internal MCP.

Поток
  1. Create .mcphub.json5 at project root
    Define project-specific servers in .mcphub.json5.✓ Скопировано
    → Servers auto-load when you open the project
  2. Verify merge
    :MCPHub status — see which servers are global vs project.✓ Скопировано
    → Merged view

Итог: Context-aware tool loadout per project.

Подводные камни
  • Committing secrets in .mcphub.json5 — Use env var references, gitignore the file if it must contain tokens

How to iterate on a custom MCP server from Neovim

👤 MCP server authors ⏱ ~15 min advanced

Когда использовать: You're building a server and want fast iteration.

Поток
  1. Enable dev mode
    Add your server with dev=true in mcphub config.✓ Скопировано
    → Hot-reload on file save
  2. Iterate
    Edit server code; mcphub restarts it transparently.✓ Скопировано
    → Updated tools without Neovim restart

Итог: Tight dev loop inside Neovim.

Комбинации

Сочетайте с другими MCP — эффект x10

mcphub-nvim + github

Use GitHub MCP from Neovim via Avante chat

Install github MCP via marketplace, then ask Avante to show PRs assigned to me.✓ Скопировано

Инструменты

Что предоставляет этот MCP

ИнструментВходные данныеКогда вызыватьСтоимость
(plugin) :MCPHub Commands: status, marketplace, install, logs Manage servers free
(plugin) marketplace-install server_name Quickly add a vetted MCP free
(integration) Avante/CodeCompanion/CopilotChat tools Chat prompts Normal chat usage 1 LLM call + tool calls

Стоимость и лимиты

Во что обходится

Квота API
None (plugin itself)
Токенов на вызов
Adds a tools list to Avante/CC prompts
Деньги
Free (MIT)
Совет
Disable unused marketplace servers — each one adds tools to your prompt budget.

Безопасность

Права, секреты, радиус поражения

Минимальные скоупы: Whatever each installed MCP needs
Хранение учётных данных: Env var references in mcphub config
Исходящий трафик: Per downstream MCP
Никогда не давайте: Don't commit .mcphub.json5 with inline secrets

Устранение неполадок

Частые ошибки и исправления

mcphub fails to start Node subprocess

Neovim's PATH may not include Node. Set vim.env.PATH or use absolute path.

Проверить: :!which node
Avante doesn't see MCP tools

Check Avante adapter version — older versions don't support MCP. Update.

Marketplace shows empty list

Network/firewall blocking marketplace URL. Check :MCPHub logs.

OAuth flow stuck in browser

Copy the URL from :MCPHub logs and paste manually; localhost redirect may not fire from Neovim context.

Альтернативы

mcphub.nvim в сравнении

АльтернативаКогда использоватьКомпромисс
CodeCompanion.nvim (native)You want LLM chat without MCP managementNo marketplace, no OAuth flows
VS Code MCPYou prefer VS CodeNot Neovim

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills