# @growthbook/mcp 中文文档

规范地址：https://npmcn.com/package/%40growthbook/mcp/

版本：2\.2\.0
npm 元数据更新时间：2026-10-06T16:51:55.725Z
中文译文更新时间：2026-11-17T01:27:17.429Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40growthbook/mcp
原文对照：https://npmcn.com/package/%40growthbook/mcp/?lang=original
项目主页：https://github.com/growthbook/growthbook-mcp
源码仓库：https://github.com/growthbook/growthbook-mcp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：407 kB，45 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：3 个
- 首次发布：2025-05-15T17:39:37.162Z
- 最新版本发布：2026-10-06T16:51:55.345Z
- 近 30 天下载量：32172（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：24（近 12 个月 15 个）

## 中文简介

GrowthBook 的瘦 MCP 服务器 — 技能加载器 + 认证的 API 通过

## 安装

```sh
npm install @growthbook/mcp
```

也可以使用：`pnpm add @growthbook/mcp`、`yarn add @growthbook/mcp`、`bun add @growthbook/mcp`

## README

# 增长手册 细

GrowthBook 的薄MCP服务器,有四个工具:

| 工具 | 目的 |
| --- | --- |
| `growthbook_list_skills` | 列出顶级技能切入点(名称+描述) |
| `growthbook_read_skill` | 返回所列技能或合格的儿童工作流程`feature-flags` 或者说 `feature-flags/references/flag-create`(中文(简体) ) |
| `growthbook_api_read` | 认证到 GrowthBook API |
| `growthbook_api_write` | 经认证的POST/PUT/PATCH/DELETE通过 |

能力生活在 [技能](https://github.com/growthbook/skills) 重新来过 **构建时捆绑**。能力被分割为读取 vs 写入 API 工具(没有每个端点格式化器),所以客户端可以遵守 `readOnlyHint` 编号 : `destructiveHint` 对.

工具前缀为 `growthbook_` 当一个客户端装入多个 MCP 服务器时, 它们会保持清晰.

## 安装/ 运行

```bash
npm install
npm run build
```

将您的 MCP 客户端指向编译的切入点 :

```json
{
  "mcpServers": {
    "growthbook": {
      "command": "node",
      "args": ["/absolute/path/to/growthbook-mcp/server/index.js"],
      "env": {
        "GB_API_KEY": "your_api_key_or_pat",
        "GB_API_URL": "https://api.growthbook.io"
      }
    }
  }
}
```

或运行已发布的软件包 :

```bash
npx @growthbook/mcp
```

## 环境变量

| 变量 | 需求 | 默认 | 目的 |
| --- | --- | --- | --- |
| `GB_API_KEY` | Stdio 是; HTTP OAuth 可选 | —— 说 | GrowthBook API 密钥或个人访问令牌 |
| `GB_API_URL` | 没有 | `https://api.growthbook.io` | API 基础 URL( 自托管) 和默认 OAuth AS 发行器 |
| `GB_MCP_TRANSPORT` | 没有 | `stdio` | `stdio` 或者说 `http` |
| `GB_MCP_PORT` | 没有 | `3333` | HTTP 听端口( 当 transport=http) |
| `GB_MCP_HOST` | 没有 | `127.0.0.1` | HTTP 绑定主机 |
| `GB_MCP_URL` | 对 HTTP | —— 说 | 公用 MCP 基址被印入 OAuth 资源元数据( 服务器拒绝在 HTTP 模式下启动) |
| `GB_MCP_KEEP_ALIVE_TIMEOUT_MS` | 没有 | `90000` | 在 HTTP 模式下, Idle 保持活性超时 。 必须超过前面任何负载平衡器的闲置超时, 或者 LB 可以重用服务器已经关闭的连接, 并且请求以 502 失败 |
| `GB_OAUTH_ISSUER` | 没有 | `GB_API_URL` | GrowthBook OAuth AS 发行器 URL |
| `GB_HTTP_HEADER_*` | 没有 | —— 说 | 额外的请求头(例如. `GB_HTTP_HEADER_CF_ACCESS_TOKEN`(中文(简体) ) |
| `GB_SKILLS_ENABLED` | 没有 | `true` | 设定为 `false` 编号 : `0` 以禁用技能工具 |

### HTTP + OAuth 模式

```bash
OAUTH_AS_ENABLED=1  # on the GrowthBook API
GB_MCP_TRANSPORT=http GB_API_URL=http://localhost:3100 GB_MCP_PORT=3333 npm start
```

客户端连接到 :

-   `http://127.0.0.1:3333/mcp` 完全(技能+API读取/写出)
-   `http://127.0.0.1:3333/mcp/api` ——只具备能力(`growthbook_api_read` + 键 `growthbook_api_write`(中文(简体) )

收到未经认证的请求 `401` 与 `WWW-Authenticate` 指点 `/.well-known/oauth-protected-resource`,用于广告 GrowthBook 授权服务器.

在处理MCP之前,服务器会探测GrowthBook REST(`GET /api/v1/`)与持者相会. A 类 `401` 从该探测器(或后来从API工具)得到 HTTP `401` 与 `error="invalid_token"` 因此, MCP 客户端可以刷新—— 而不是上浮 `"This API key has expired"` 作为工具错误。 A 类 `403` 因此客户不会被迫进入一个刷新循环.

### 仅能模式

**HTTP( 建议远程) :** 指示客户端 `/mcp/api` 改为 `/mcp`数字 :

```json
{
  "mcpServers": {
    "growthbook": {
      "url": "http://127.0.0.1:3333/mcp/api"
    }
  }
}
```

| 路径 | 工具 |
| --- | --- |
| `/mcp` | `growthbook_list_skills`, (中文(简体) ), `growthbook_read_skill`, (中文(简体) ), `growthbook_api_read`, (中文(简体) ), `growthbook_api_write` (除非 `GB_SKILLS_ENABLED=false`(中文(简体) ) |
| `/mcp/api` | `growthbook_api_read`, (中文(简体) ), `growthbook_api_write` 仅限 |

**stdio/全过程:** 设置嵌入, 因此技能从未注册 :

```json
"env": {
  "GB_API_KEY": "...",
  "GB_SKILLS_ENABLED": "false"
}
```

技能被禁用时,只登记API读取/写出工具. `growthbook_list_skills` 财务报告和审定财务报表 `growthbook_read_skill` 没有暴露.

## 技能如何捆绑

```bash
npm run build   # tsc && bundle-skills
```

`scripts/bundle-skills.mjs` 从 canonial 技能检查复制顶级技能树, 保存结构 :

```
skills/<skill>/SKILL.md                   → server/skills/<skill>/SKILL.md
skills/<skill>/references/<workflow>.md   → server/skills/<skill>/references/<workflow>.md
```

源路径解析度 :

1.  `SKILLS_SRC` env var (通过技能回波根)
2.  `agent-skills.local.json` —— 说 `{ "path": "../skills" }`,相对于 repo 根。 吉吉诺已忽略; 副本 `agent-skills.local.json.example`
3.  `skills-src/` ——CI和多克建造的供应商

没有隐含的哥哥的相貌. `../skills` 决心解决任何发生在这条道路上的问题,这使当地建筑沉默地不同意CI所建立的承诺.

CI,云部署,并发布全部读取 `agent-skills.lock.json` 检查出来 精准的技能承诺。 为进行上游技能变革,更新承诺 锁文件。 本地开发可以指: 任何离职 `agent-skills.local.json` 或者说 `SKILLS_SRC`。 。 。 .

技能回波仍然是真相的来源——这个软件包不维持 技术含量分叉. 新的技能自动流出, 除了那些命名 在小块列表中 `bundle-skills.mjs`。目前仅 `gb-setup` 实值 因为它配置 `gb-call` 外壳适配器而非生长本 自己来.

个人技能 `scripts/` 目录未复制 。 相对 `` `references/foo.md` `` 链接重写为合格 `` `feature-flags/references/foo` `` 路径 `growthbook_read_skill` 可以解决 他们.

## 使用 API 工具的技能

捆绑的技能仍然显示工作流程如下:

```bash
gb-call GET /api/v1/projects
gb-call POST /api/v2/features ./payload.json
```

这个 MCP 服务器有 **没有** 外壳到 `gb-call`地图 `GET` → `growthbook_api_read` 财务报告和审定财务报表 `POST`编号 :`PUT`编号 :`PATCH`编号 :`DELETE` → `growthbook_api_write` 同一路径和可选的JSON体弦。 服务器指令和 `growthbook_read_skill` 输出包括此桥条.

## 工具细节

### `growthbook_api_read` 编号 : `growthbook_api_write`

```json
{ "path": "/api/v1/projects" }
{ "method": "POST", "path": "/api/v2/features", "body": "{\"id\":\"my-flag\",...}" }
```

-   读取: 仅获取( R)`readOnlyHint: true`(中文(简体) )
-   写入 : `POST` | `PUT` | `PATCH` | `DELETE` (单位:千美元)`destructiveHint: true`(中文(简体) )
-   2xx上返回原始响应机构
-   在非-2xx上,返回一个可操作错误(`isError: true`) 涵盖认证失败、自寄404个提示和利率限制
-   Freeform 路径瞄准 [增长 Book REST API](https://docs.growthbook.io/api)
-   每个请求都带有 MCP 使用页眉(参见 [用法遥测](https://npmcn.com/package/%40growthbook/mcp/#readme-usage-telemetry)(中文(简体) )

### `growthbook_list_skills` 编号 : `growthbook_read_skill`

仅在 `GB_SKILLS_ENABLED` 未禁用.

-   `growthbook_list_skills` 返回顶级技能切入点。 一个条目可能包含一个完整的工作流程或通往儿童工作流程的路径.
-   `growthbook_read_skill` 接受以加载技能命名的列表顶级名称或合格子路径(`feature-flags/references/flag-create`)并返回全部标记下(工作流程+护栏).

## 用法遥测

这台服务器从不发送遥测设备 反之,每一次REST呼叫 由 `growthbook_api_read` 编号 : `growthbook_api_write` 包括那些告诉GrowthBook案例的 信头,它正在谈论,电话来自MCP:

| 页眉 | 示例 | 目录 |
| --- | --- | --- |
| `X-GB-MCP-Tool` | `growthbook_api_read` | 打电话的工具 |
| `X-GB-MCP-Version` | `2.2.0` | 此服务器的版本 |
| `X-GB-MCP-Transport` | `stdio` | `stdio` 或者说 `http` |
| `X-GB-MCP-Client` | `cursor/1.2.3` | MCP客户端的名字/版本来自初始化握手方式,或其 `User-Agent` 在 HTTP 模式下 |

GrowthBook通过它现有的产品遥测记录这些,所以同样的控制适用. 在自主办的情况下 `DISABLE_TELEMETRY` 在GrowthBook的后端 和GrowthBook的其他遥测功能一起关闭了它。 更古老的GrowthBook版本忽略了标题. 技能工具(`growthbook_list_skills` 编号 : `growthbook_read_skill`)在当地服务,不提出请求,所以没有跟踪.

## 发展

```bash
git clone git@github.com:growthbook/skills.git ../skills
cp agent-skills.local.json.example agent-skills.local.json  # edit if not at ../skills

npm install
npm run build
npm start
```

## 独立的 HTTP 模式

默认服务器运行于 stdio. 设定 `GB_MCP_TRANSPORT=http` 以独立 HTTP 服务器运行,以在 `/mcp` (技能+API工具)和 `/mcp/api` OAuth 2.0保护资源表面(RFC 9728元数据+RFC 6750)背后的(只具备能力) `WWW-Authenticate`) (中文(简体) ).

-   `GB_MCP_URL` (单位:千美元)**所需经费** 在HTTP模式下)——服务器的公共基础URL. 它被印入 OAuth 资源( auditence) 和保护资源元数据, 因此它从未从请求头中产生 。 服务器拒绝在没有它的情况下启动 .
-   `GB_MCP_PORT` (默认) `3333`和 `GB_MCP_HOST` (默认) `127.0.0.1`) (中文(简体) ).
-   通过检测 GrowthBook REST API 验证了来信持有人;一个被拒绝的符号获得 HTTP `401` + 键 `WWW-Authenticate` 这样客户可以刷新.

在可信任的网络上运行,或绑定回放. 对于多租户或公众的部署,请用你自己的网关/自动门前.

## 释放

剪辑版本是故意的:将版本打入 `package.json`匹配 `v*` 标签 :

```bash
git tag v2.0.0
git push origin v2.0.0
```

贴有标签的执业者(技能被冻结在停机时间)发表:

-   `@growthbook/mcp` 至 npm——预放(版本为a) `-`,比如说. `2.0.0-beta.1`下潜 `beta` ditt-tag; 稳定版本变为 `latest`
-   一个多结构( e)`amd64` + 键 `arm64`图像到 `ghcr.io/growthbook/growthbook-mcp` (单位:千美元)`:<version>`附加时 `:<major>`, (中文(简体) ), `:<major>.<minor>`,以及 `:latest` (稳定释放)
-   列入MCP登记册
-   a GitHub 发布

安装发布器 `npx @growthbook/mcp@<version>` 或拉动 `ghcr.io/growthbook/growthbook-mcp:<version>`。 。 。 .

## 常见问题

### @growthbook/mcp 是什么？

GrowthBook 的瘦 MCP 服务器 — 技能加载器 \+ 认证的 API 通过

### 如何安装 @growthbook/mcp？

在项目目录运行 npm install @growthbook/mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mcp，可以用 npx mcp 直接运行。

### @growthbook/mcp 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/growthbook\_\_mcp 是否存在。

### @growthbook/mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @growthbook/mcp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @growthbook/mcp 可以商用吗？

@growthbook/mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @growthbook/mcp 的下载量有多少？

根据 npm 官方下载统计，@growthbook/mcp 在 2026/10/17 – 2026/11/15 这 30 天内被下载 32,172 次，日均约 1,072 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @growthbook/mcp 还在维护吗？

最新版本 2\.2\.0 发布于 2026/10/07（1 个月前）；至今共发布 24 个版本，其中过去 12 个月发布了 15 个；首次发布于 2025/05/16。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

