---

MCP Hub 是一个适用于 Neovim 的 MCP 客户端，可将 MCP（模型上下文协议） 服务器无缝集成到你的编辑工作流中。它提供了一个直观的界面，用于管理、测试和使用你最喜欢的聊天插件中的 MCP 服务器。

💜 赞助商

特别感谢：

✨ 功能

类别	功能	支持	详情
能力
	工具	✅	完全支持
	🔔 工具列表变更	✅	实时更新
	资源	✅	完全支持
	🔔 资源列表变更	✅	实时更新
	资源模板	✅	URI 模板
	提示	✅	完全支持
	🔔 提示列表变更	✅	实时更新
	根	❌	不支持
	采样	❌	不支持
MCP 服务器传输方式
	可流式HTTP	✅	远程服务器的主要传输协议
	SSE	✅	远程服务器的备用传输方式
	STDIO	✅	用于本地服务器
远程服务器的身份验证
	OAuth	✅	带 PKCE 流程
	头部信息	✅	用于 API 密钥/令牌
聊天集成
	Avante.nvim	✅	工具、资源、资源模板、提示（作为 slash_commands）
	CodeCompanion.nvim	✅	工具、资源、模板、提示（作为 slash_commands）、🖼 图像响应
	CopilotChat.nvim	✅	工具、资源、函数调用支持
市场
	服务器发现	✅	可浏览经过验证的 MCP 服务器
	安装	✅	手动安装以及借助 AI 自动安装
配置
	通用 ${} 语法	✅	环境变量及命令执行贯穿所有字段
	VS Code 兼容性	✅	支持 servers 键、${env:}、${input:} 以及预定义变量
	JSON5 支持	✅	通过 lua-json5 支持注释和尾随逗号
工作区管理
	项目本地配置	✅	自动检测并与全局配置合并
高级功能
	智能文件监听	✅	通过监听配置文件实现智能更新
	多实例	✅	所有 Neovim 实例保持同步
	关机延迟	✅	可以作为 systemd 服务运行，并在停止中心之前设置延迟
	Lua 原生 MCP 服务器	✅	一次编写，处处可用。可以直接用 Lua 编写工具、资源和提示
	开发模式	✅	文件更改时热重载 MCP 服务器，便于开发

🎥 演示

🚀 快速入门

访问我们的 文档网站 获取详细指南和示例

👋 获取帮助

• 查看 故障排除指南
• 加入我们的 Discord 服务器 进行讨论、获取帮助和了解最新动态

:gift: 贡献

请阅读 CONTRIBUTING.md 指南。

🚧 待办事项

• Neovim MCP 服务器（某种程度上）：改进编辑功能、差异对比、终端集成等（欢迎提出想法）
• 增强的帮助视图，包含全面的文档
• 将 MCP 资源作为聊天插件中的变量
• 将 MCP 提示作为聊天插件中的斜杠命令
• 允许 LLM 动态启动和停止 MCP 服务器
• 支持 SSE 传输协议
• 在 avante 中支持 /slash_commands
• 支持可流式传输的 HTTP 传输协议
• 支持 OAuth
• 添加类型定义
• 完善文档
• 添加测试
• 在 avante 中支持 #variables

👏 致谢

感谢以下项目：

• nui.nvim：启发了我们的文本高亮工具
• ravitemer/mcp-registry：提供了市场 API

mcphub.nvim 快速上手指南

mcphub.nvim 是一个专为 Neovim 设计的 MCP (Model Context Protocol) 客户端。它能无缝集成 MCP 服务器到你的编辑工作流中，提供直观的界面来管理、测试和使用 MCP 服务，并支持与 Avante、CodeCompanion、CopilotChat 等主流 AI 聊天插件联动。

环境准备

在开始之前，请确保你的开发环境满足以下要求：

• Neovim: 版本 >= 0.9.0 (推荐最新稳定版)。
• Lua: 内置于 Neovim，无需单独安装。
• 依赖插件:
  • nui.nvim: 用于构建 UI 界面（通常由 mcphub.nvim 自动处理或需手动安装，建议通过包管理器一并安装）。
• MCP 服务器: 根据你需要使用的功能，提前准备好相应的 MCP 服务器环境（如 Node.js, Python 等运行时）。
• 网络环境: 如果使用远程 MCP 服务器或市场功能，请确保网络畅通。国内用户若遇到连接 GitHub 或外部源缓慢的情况，建议配置合适的网络代理。

安装步骤

推荐使用 Lua 包管理器（如 lazy.nvim）进行安装。

1. 使用 lazy.nvim 安装

在你的 Neovim 插件配置文件中（通常是 ~/.config/nvim/lua/plugins/mcphub.lua 或类似位置），添加以下配置：

return {
  "ravitemer/mcphub.nvim",
  dependencies = {
    "MunifTanjim/nui.nvim",
    "nvim-lua/plenary.nvim", -- 可选，部分功能可能需要
  },
  config = function()
    require("mcphub").setup({
      -- 在这里添加你的自定义配置
      -- 例如：启用市场功能、配置日志级别等
    })
  end,
}

2. 重新加载配置

安装完成后，重启 Neovim 或在命令模式下执行 :source % (如果在配置文件中) 或 :Lazy sync 来同步并加载插件。

基本使用

安装完成后，你可以通过以下步骤快速开始使用：

1. 打开 MCP Hub 界面

在 Neovim 正常模式下，输入以下命令打开主界面：

:McpHub

该界面将显示已连接的服务器状态、可用工具 (Tools)、资源 (Resources) 和提示词 (Prompts)。

2. 配置 MCP 服务器

mcphub.nvim 支持多种配置方式，包括本地 JSON/JSON5 配置文件。

创建一个配置文件（例如 ~/.config/nvim/mcp.json 或项目根目录下的 .mcp.json），添加服务器定义：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/your/project"]
    },
    "github": {
      "command": "node",
      "args": ["/path/to/github-mcp-server/build/index.js"],
      "env": {
        "GITHUB_TOKEN": "${env:GITHUB_TOKEN}" // 支持环境变量
      }
    }
  }
}

注：插件支持 ${env:VAR} 语法读取环境变量，也支持 JSON5 格式（允许注释和尾随逗号）。

配置保存后，Hub 界面通常会自动热重载，或通过命令 :McpHubReloadConfig 手动刷新。

3. 与 AI 聊天插件联动

这是 mcphub.nvim 的核心功能。配置好服务器后，它会自动桥接至支持的聊天插件：

• Avante.nvim: MCP Tools 可直接调用，Prompts 可作为 / 斜杠命令使用。
• CodeCompanion.nvim: 支持 Tools、Resources 以及图片响应。
• CopilotChat.nvim: 支持函数调用 (Function Calling)。

示例场景： 在安装了 github MCP 服务器后，打开 CodeCompanion 或 Avante 的聊天窗口，直接询问：“列出当前仓库最近的 Issues"，AI 将自动调用 MCP 工具获取数据并回答，无需手动复制粘贴。

4. 浏览和安装服务器 (市场功能)

在 :McpHub 界面中，你可以访问内置的市场 (Marketplace)：

1. 进入市场视图。
2. 浏览经过验证的 MCP 服务器列表。
3. 选择需要的服务器，插件支持一键安装（需满足对应运行环境）或生成配置模板。

---

更多高级配置（如 OAuth 认证、多实例同步、Lua 原生编写服务器等），请参阅官方文档。