@growthbook/mcp

中文文档
2.2.0发布于 2026/10/07MITES Module构建来源已验证近 30 天下载 3.2万

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

中文使用文档
文档目录13 节
  1. 安装/ 运行
  2. 环境变量
  3. HTTP + OAuth 模式
  4. 仅能模式
  5. 技能如何捆绑
  6. 使用 API 工具的技能
  7. 工具细节
  8. growthbook_api_read 编号 : growthbook_api_write
  9. growthbook_list_skills 编号 : growthbook_read_skill
  10. 用法遥测
  11. 发展
  12. 独立的 HTTP 模式
  13. 释放

增长手册 细

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通过

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

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

安装/ 运行

npm install
npm run build

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

{
  "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"
      }
    }
  }
}

或运行已发布的软件包 :

npx @growthbook/mcp

环境变量

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

HTTP + OAuth 模式

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数字 :

{
  "mcpServers": {
    "growthbook": {
      "url": "http://127.0.0.1:3333/mcp/api"
    }
  }
}
路径工具
/mcpgrowthbook_list_skills, (中文(简体) ), growthbook_read_skill, (中文(简体) ), growthbook_api_read, (中文(简体) ), growthbook_api_write (除非 GB_SKILLS_ENABLED=false(中文(简体) )
/mcp/apigrowthbook_api_read, (中文(简体) ), growthbook_api_write 仅限

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

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

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

技能如何捆绑

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 工具的技能

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

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

{ "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
  • 每个请求都带有 MCP 使用页眉(参见 用法遥测(中文(简体) )

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-Toolgrowthbook_api_read打电话的工具
X-GB-MCP-Version2.2.0此服务器的版本
X-GB-MCP-Transportstdiostdio 或者说 http
X-GB-MCP-Clientcursor/1.2.3MCP客户端的名字/版本来自初始化握手方式,或其 User-Agent 在 HTTP 模式下

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

发展

git clone [email protected]: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* 标签 :

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 共发布 24 个版本,首次发布于 2025/05/16;过去 12 个月发布了 15 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.2.0latest2026/10/071 个月前
2.1.02026/08/123 个月前
2.0.02026/07/313 个月前
1.8.12026/03/108 个月前
1.8.02026/03/098 个月前
1.7.02026/03/078 个月前

关于 @growthbook/mcp 的常见问题

@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 和提交记录判断。