/ 目录 / 演练场 / 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. 通过插件管理器安装
    将 ravitemer/mcphub.nvim 添加到你的 lazy.nvim 配置中,使用 opts = { ... }。✓ 已复制
    → :MCPHub 打开管理界面
  2. 从市场安装一个服务器
    :MCPHub marketplace — 搜索 'github' 并安装。✓ 已复制
    → 服务器启动,工具已注册
  3. 通过 Avante 使用
    在 Avante 聊天中提问——Avante 会接收 MCP 工具。✓ 已复制
    → 工具调用在 Avante 输出中可见

结果: MCP 工具在编辑器内可用,无需切换上下文。

注意事项
  • Neovim 内的 PATH 中没有 Node — 在配置中使用绝对路径,或确保 Neovim 继承你的 shell 环境

如何设置项目本地 MCP 服务器并与全局配置合并

👤 使用不同工具链的多语言开发者 ⏱ ~15 min intermediate

何时使用: 一个项目需要 postgres MCP,另一个需要定制的内部 MCP。

步骤
  1. 在项目根目录创建 .mcphub.json5
    在 .mcphub.json5 中定义项目特定的服务器。✓ 已复制
    → 打开项目时服务器自动加载
  2. 验证合并
    :MCPHub status — 查看哪些服务器是全局的或项目本地的。✓ 已复制
    → 合并视图

结果: 每个项目的上下文感知工具配置。

注意事项
  • 在 .mcphub.json5 中提交密钥 — 使用环境变量引用,如果文件必须包含令牌,则将其添加到 gitignore

如何在 Neovim 中迭代自定义 MCP 服务器

👤 MCP 服务器作者 ⏱ ~15 min advanced

何时使用: 你正在构建一个服务器并希望快速迭代。

步骤
  1. 启用开发模式
    在 mcphub 配置中添加你的服务器,设置 dev=true。✓ 已复制
    → 文件保存时热重载
  2. 迭代
    编辑服务器代码;mcphub 透明地重启它。✓ 已复制
    → 无需重启 Neovim 的更新工具

结果: Neovim 中高效的开发循环。

组合

与其他 MCP 搭配,撬动十倍杠杆

mcphub-nvim + github

通过 Avante 聊天从 Neovim 使用 GitHub MCP

通过市场安装 github MCP,然后要求 Avante 显示分配给我的 PR。✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
(plugin) :MCPHub Commands: status, marketplace, install, logs 管理服务器 free
(plugin) marketplace-install server_name 快速添加经过验证的 MCP free
(integration) Avante/CodeCompanion/CopilotChat tools Chat prompts 常规聊天使用 1 LLM call + tool calls

成本与限制

运行它的成本

API 配额
无(插件本身)
每次调用 Token 数
向 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 并手动粘贴;localhost 重定向可能不会从 Neovim 上下文触发。

替代方案

mcphub.nvim 对比其他方案

替代方案何时用它替代权衡
CodeCompanion.nvim(原生)你想要 LLM 聊天而不需要 MCP 管理没有市场,没有 OAuth 流程
VS Code MCP你更喜欢 VS Code不是 Neovim

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills