mcphub.nvim — Neovim MCP Client & UI

简介

Neovim 的 MCP 客户端：通过 mcp-hub 管理 servers，并提供交互式 :MCPHub UI，让聊天插件可以浏览、测试并调用 tools/prompts，把编辑器变成工具面板。

• 适合谁： 想在 Neovim 里管理并测试 MCP servers、并与聊天插件联动的用户
• 可搭配： Neovim、Node.js、mcp-hub；可与常见 Neovim 聊天插件集成
• 准备时间： 15–30 分钟

实战建议

• 量化建议：先只接入 1 个 server + 3 次 tool 调用，把从打开 :MCPHub 到首次成功调用的耗时压到 <2 分钟。
• 量化建议：严格记录版本门槛（Neovim >= 0.8、Node.js >= 18），避免环境漂移导致的“偶发不可用”。

让编辑器里的 MCP 更像“原生功能”

建议把三层分开管理，复杂度会明显下降：

1. Server 定义（跑什么、环境变量是什么）
2. UI 发现/测试（把 :MCPHub 当作工具控制台）
3. 聊天插件集成（只接入你真正要用的少数 tools）

排障清单

• 先确认 Node.js 与 Neovim 版本。
• 确认 mcp-hub 已安装且在 PATH 里（Lazy 的 build 步可完成）。
• 从一个最小 server/tool 起步，跑通再扩展。

团队化建议

把 MCP server 配置纳入版本管理：走 code review、写变更记录、准备回滚方案。

FAQ

必须单独装 mcp-hub 吗？ 答：推荐的 Lazy.nvim 配置会在 build 步中安装 mcp-hub。

要把所有工具都接到聊天插件里吗？ 答：不要。先从 1–3 个最常用工具开始，再有意识地扩展。

最常见的故障点是什么？ 答：版本漂移（Neovim/Node）与 mcp-hub 在 PATH 中不可用。