mcphub.nvim MCP — 사용 사례, 설치 & 라이브 데모

왜 쓰나요

핵심 기능

Verified marketplace of MCP servers with one-command install
Full MCP feature support: tools, resources, templates, prompts
OAuth PKCE + API key auth
Integration with Avante.nvim, CodeCompanion.nvim, CopilotChat.nvim
Project-local config merging, JSON5 config syntax

라이브 데모

실제 사용 모습

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는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

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

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "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는 맵이 아닌 서버 오브젝트 배열 사용.

~/.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

흐름

Install via plugin manager

Add ravitemer/mcphub.nvim to your lazy.nvim config with opts = { ... }.✓ 복사됨

→ :MCPHub opens the management UI
Install a server from the marketplace

:MCPHub marketplace — search 'github' and install.✓ 복사됨

→ Server starts, tools registered
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.

흐름

Create .mcphub.json5 at project root

Define project-specific servers in .mcphub.json5.✓ 복사됨

→ Servers auto-load when you open the project
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.

흐름

Enable dev mode

Add your server with dev=true in mcphub config.✓ 복사됨

→ Hot-reload on file save
Iterate

Edit server code; mcphub restarts it transparently.✓ 복사됨

→ Updated tools without Neovim restart

결과: Tight dev loop inside Neovim.

조합

다른 MCP와 조합해 10배 효율

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

Marketplace entries are community-submitted — verify publisher before installing.

문제 해결

자주 발생하는 오류와 해결

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 management	No marketplace, no OAuth flows
VS Code MCP	You prefer VS Code	Not Neovim

mcphub.nvim