/ ディレクトリ / プレイグラウンド / mcphub.nvim
● コミュニティ ravitemer ⚡ 即起動

mcphub.nvim

作者 ravitemer · ravitemer/mcphub.nvim

Neovim プラグイン。エディタを第一級の MCP クライアントに変えます。マーケットプレイス インストール、Avante/CodeCompanion 統合、OAuth PKCE に対応します。

ravitemer/mcphub.nvim は MCP サーバを Neovim ワークフローに統合します。検証済みマーケットプレイスで発見・インストール、Avante/CodeCompanion/CopilotChat でチャット、OAuth 管理、開発サーバのホットリロードに対応。stdio、SSE、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 は 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

Avante または CodeCompanion 経由で Neovim から MCP サーバを使用する方法

👤 Neovim 開発者 ⏱ ~20 min intermediate

使うタイミング: Neovim で開発していて、MCP アクセスのために VS Code に切り替えたくない場合。

前提条件
  • Neovim 0.10+ — brew install neovim
  • Avante.nvim または CodeCompanion.nvim がインストール済み — プラグインマネージャ(lazy.nvim/packer)経由
  • mcphub.nvim + Node 依存 — インストール スニペットは ravitemer.github.io/mcphub.nvim を参照
フロー
  1. プラグインマネージャ経由でインストール
    lazy.nvim 設定に ravitemer/mcphub.nvim を追加します(opts = { ... } 付き)。✓ コピーしました
    → :MCPHub が管理画面を開く
  2. マーケットプレイスからサーバをインストール
    :MCPHub marketplace — 'github' を検索してインストール。✓ コピーしました
    → サーバが起動、ツールが登録される
  3. Avante 経由で使用
    Avante チャットで質問を入力します。Avante が MCP ツールを認識します。✓ コピーしました
    → ツール呼び出しが Avante 出力に表示される

結果: エディタ内で MCP ツールが使用可能、コンテキスト切り替えなし。

注意点
  • Neovim 内で Node が PATH にない — 設定で絶対パスを使用するか、Neovim がシェル環境を継承していることを確認

プロジェクトローカル MCP サーバをグローバル設定とマージしながらセットアップする方法

👤 プロジェクトごとに異なるツールセットを使う多言語開発者 ⏱ ~15 min intermediate

使うタイミング: あるプロジェクトは postgres MCP が必要で、別のプロジェクトはカスタム内部 MCP が必要な場合。

フロー
  1. プロジェクトルートに .mcphub.json5 を作成
    .mcphub.json5 でプロジェクト固有のサーバを定義します。✓ コピーしました
    → プロジェクトを開くとサーバが自動ロードされる
  2. マージを確認
    :MCPHub status — グローバルサーバ vs プロジェクトサーバを確認。✓ コピーしました
    → マージされたビュー

結果: プロジェクトごとのコンテキスト対応ツール構成。

注意点
  • .mcphub.json5 にシークレットをコミット — 環境変数参照を使用するか、トークンが含まれている場合は gitignore に追加

Neovim からカスタム MCP サーバを反復開発する方法

👤 MCP サーバ作成者 ⏱ ~15 min advanced

使うタイミング: サーバを構築していて、高速な反復開発を望む場合。

フロー
  1. 開発モードを有効化
    mcphub 設定で dev=true を指定してサーバを追加します。✓ コピーしました
    → ファイル保存時のホットリロード
  2. 反復開発
    サーバコードを編集します。mcphub が透過的に再起動します。✓ コピーしました
    → Neovim 再起動なしでツール更新

結果: Neovim 内での緊密な開発ループ。

組み合わせ

他のMCPと組み合わせて10倍の力を

mcphub-nvim + github

Avante チャット経由で Neovim から GitHub MCP を使用

マーケットプレイスから github MCP をインストールし、Avante に自分に割り当てられた PR を表示するよう依頼します。✓ コピーしました

ツール

このMCPが提供する機能

ツール入力呼び出すタイミングコスト
(plugin) :MCPHub コマンド:status、marketplace、install、logs サーバを管理 free
(plugin) marketplace-install server_name 検証済み MCP を素早く追加 free
(integration) Avante/CodeCompanion/CopilotChat tools チャット プロンプト 通常のチャット使用 1 LLM call + tool calls

コストと制限

運用コスト

APIクォータ
なし(プラグイン自体)
呼び出しあたりのトークン
Avante/CC プロンプトにツール一覧を追加
金額
無料(MIT)
ヒント
未使用のマーケットプレイスサーバを無効化します。各サーバがプロンプト予算にツールを追加するため。

セキュリティ

権限、シークレット、影響範囲

最小スコープ: 各インストール済み MCP に必要なスコープ
認証情報の保管: mcphub 設定の環境変数参照
データ送信先: ダウンストリーム MCP ごと
絶対に付与しない: .mcphub.json5 にインラインシークレットを含めてコミットしない

トラブルシューティング

よくあるエラーと対処法

mcphub が Node サブプロセスの起動に失敗

Neovim の PATH に Node が含まれていない可能性があります。vim.env.PATH を設定するか、絶対パスを使用してください。

確認: :!which node
Avante が MCP ツールを認識しない

Avante アダプタのバージョンを確認してください。古いバージョンは MCP をサポートしていません。アップデートしてください。

マーケットプレイスが空のリストを表示

ネットワーク/ファイアウォールがマーケットプレイス URL をブロックしている可能性があります。:MCPHub ログを確認してください。

OAuth フローがブラウザで停止

:MCPHub ログから URL をコピーして手動で貼り付け��ください。Neovim コンテキストから localhost リダイレクトが発火しない場合があります。

代替案

mcphub.nvim 他との比較

代替案代わりに使う場面トレードオフ
CodeCompanion.nvim (ネイティブ)LLM チャットを MCP 管理なしで望む場合マーケットプレイスなし、OAuth フローなし
VS Code MCPVS Code を好む場合Neovim ではない

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る