@nimbus-dev/mcp

这是什么

一个微型启动器，将你本地的 Nimbus 索引和代理暴露给任何 MCP（Model Context Protocol）客户端——编辑器、聊天客户端或其他支持 MCP 的工具。它本身不做任何工作：它定位你机器上已安装的 Nimbus CLI 二进制文件，并以 nimbus mcp-server --stdio 方式执行它，然后让开，让 stdio 直接通过。

本包采用 MIT 许可证，不依赖（也不导入）AGPL-3.0 的 packages/cli 或 packages/gateway Nimbus 源码——它只知道如何找到已安装的二进制文件，从不运行网关本身。

要求 Nimbus 网关已安装。 此启动器不会安装或捆绑 Nimbus；请先运行常规的 Nimbus 安装程序，并保持网关按你通常使用的方式配置（mcp-server --stdio 命令与你现有的本地索引通信）。

Related MCP server: mcp-cli-catalog

安装

尚未发布到 npm。 @nimbus-dev/mcp 没有 release-please 条目，也没有发布工作流——注册表提交被有意推迟到发布活动中。下面的 npm / npx 说明是发布后你会用到的；在此之前，请使用从本地检出运行。

直接从你的 MCP 客户端配置中运行它（见下文），无需全局安装，或显式安装它：

npm install -g @nimbus-dev/mcp

快速开始

在你的 MCP 客户端的服务器配置中添加 nimbus-mcp 作为命令，例如：

{
  "mcpServers": {
    "nimbus": {
      "command": "npx",
      "args": ["-y", "@nimbus-dev/mcp"]
    }
  }
}

从本地检出运行

在包发布之前，请将你的 MCP 客户端直接指向 Nimbus 仓库克隆中的启动器入口点。使用绝对路径——编辑器生成的 MCP 服务器不会继承你 shell 的工作目录：

{
  "mcpServers": {
    "nimbus": {
      "command": "bun",
      "args": ["/absolute/path/to/nimbus-mcp/src/index.ts"]
    }
  }
}

如果你已经安装了 Nimbus CLI，可以完全跳过启动器，让客户端直接运行 nimbus mcp-server --stdio——启动器只是为你找到那个二进制文件。

如何找到二进制文件

启动器按以下顺序查找 Nimbus 二进制文件：

1. NIMBUS_BIN — 如果设置了，则为二进制文件的显式完整路径。指向不存在文件的 NIMBUS_BIN 会作为错误报告，绝不会被静默忽略。

2. PATH — 在你的 PATH 中找到的第一个 nimbus（Windows 上为 nimbus.exe）。

3. 已知的按平台安装目录，安装程序自身的输出目录优先：Windows 上的 %LOCALAPPDATA%\Programs\Nimbus\bin，macOS 和 Linux 上的 ~/.local/bin，然后是 /opt/homebrew/bin 和 /usr/local/bin（macOS）或 /usr/local/bin 和 /usr/bin（Linux）。

第 3 步是 macOS 上 GUI 启动的编辑器所依赖的，这类编辑器通常在缺少你 shell 的 PATH 的情况下生成 MCP 服务器。如果以上都无法解析，启动器会以一条指明修复方法的消息退出——绝不会只返回一个裸退出码。

环境变量

• NIMBUS_BIN — 覆盖解析出的二进制路径。将其指向确切的 Nimbus CLI 可执行文件。

• NIMBUS_MCP_TIMEOUT_MS — Nimbus CLI 的 MCP 适配器在返回干净的超时错误之前等待代理简报的时间；默认为 60 秒。当你的编辑器自身的 MCP 传输超时更短时，请调低此值，以便工具报告超时，而不是让调用在底层被切断。这是适配器自身的预算——网关不施加此类超时。它由底层的 nimbus mcp-server 进程读取，此启动器以你未更改的环境继承方式执行该进程。

另请参阅

• docs/architecture.md — Nimbus 子系统设计和 MCP 连接器标准。

• 网关的 mcp-server 命令，位于主 Nimbus 仓库中（packages/gateway、packages/cli）——本包启动它，但不包含它，也不为其提供许可。

许可证

MIT — 参见 LICENSE。请注意，此启动器执行的 Nimbus 网关和 CLI 分别根据 AGPL-3.0 获得许可。