GrowthBook MCP Server

官方

官方 GrowthBook MCP 服务器：技能加载 + 已认证的 API 直通

分类: 开发工具第 121 / 438
Stars: ★ 24 热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js · Docker
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 14 天前
工具数: 3

60FMRS · C

官方维护的轻量 GrowthBook MCP 服务器，设计精简：技能内容在构建时打包、能力层是单一通用 API 直通工具，凭统一前缀避免多服务器混淆。HTTP 模式的 OAuth 与令牌刷新处理较为完善。适合已有 GrowthBook 的团队，但修改性调用依赖软性确认，需谨慎授权。

最强项 · 文档质量 16/20 最弱项 · 可靠性 9/20

可靠性

9/20

安全与权限

9/20

维护活跃度

13/20

文档质量

16/20

安装易用性

13/20

查看各项评分依据

可靠性 9/20: README 描述了三个工具（growthbook_list_skills、growthbook_read_skill、growthbook_call_api）及其行为，manifest 中的版本号（2.1.0）与包版本一致，说明文档内部基本自洽。但本次审查未见任何 CI 工作流文件或已提交的测试用例作为可验证的执行证据，构建流程依赖同级目录 ../skills（或 SKILLS_SRC 环境变量）才能完成 bundle-skills 步骤，这是一个未经验证的外部依赖点，一旦缺失会导致构建失败。按静态评审规则，无可验证执行证据时可靠性上限为 12 分，扣分后评为 9 分。
安全与权限 9/20: GB_API_KEY 被正确标记为必需且敏感（is_secret），HTTP 模式下有 OAuth 保护资源元数据、bearer 校验和默认绑定 127.0.0.1 的合理默认值，体现了一定的最小暴露设计。但核心工具 growthbook_call_api 是通用的、无端点限制的 REST 透传，支持 POST/PUT/PATCH/DELETE 等有副作用甚至不可逆的操作，README 明确说明其确认机制只是"软性指导"（写在工具描述里提示代理确认），而非代码层面强制的硬性门禁，任何忽略该提示的代理调用都可能直接执行不可逆的删除等操作。这是明显的权限与二次确认缺口，因此不能给高分；同时 GB_HTTP_HEADER_* 允许任意自定义请求头，增加了潜在的数据流不透明性。综合评为 9 分（非红线级别，因为文档已充分披露该限制，且没有证据显示存在默认无确认的破坏性操作或凭据泄露）。
维护活跃度 13/20: 仓库使用 MIT 许可证，未被归档，发布流程文档化程度高（tag 触发的多架构 Docker 镜像、npm 发布、GitHub Release、MCP 注册表条目），显示出较为规范的版本治理。但 23 星对应 21 个未关闭 issue，issue 与关注度的比例偏高，且未见 commit 频率、issue 响应时间或依赖更新机制的直接证据，这些方面的不确定性导致无法给出更高分数。
文档质量 16/20: README 内容层次分明，涵盖安装、环境变量表、stdio/HTTP 两种运行模式、OAuth 认证流程、capability-only 模式、工具参数示例、开发环境要求及发布流程，覆盖面较全且有具体命令示例。不足之处在于对 API 调用频率限制、成本影响的说明较为简略，故障排查部分也仅覆盖了鉴权失败等有限场景，未构成完整的故障排查指南，因此未给满分。
安装易用性 13/20: 文档给出了清晰的多路径安装方式：npx 直接运行、Docker 镜像拉取、或本地 npm install && npm run build，并附带 stdio 和 HTTP 两种客户端配置 JSON 示例，覆盖主流客户端场景。但本地源码构建依赖同级 ../skills 检出或 SKILLS_SRC 环境变量，属于隐藏的运行时前置条件，若使用者选择源码构建路径会增加复杂度和失败可能性。由于静态评审在缺乏可验证执行证据时安装易用性上限为 15 分，加上上述构建依赖的脆弱性，评为 13 分。

静态评测 · 未实际运行收录于 2026-09-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

已使用 GrowthBook 并希望用 AI 代理管理开关与实验的团队
需要已认证、可审计 API 直通的 MCP 用户
自托管实例运维人员

不适合谁

未使用 GrowthBook 的用户
没有 GrowthBook API 密钥的只读浏览场景
不希望代理发起修改性 API 调用的环境

所需权限

GB_API_KEY：GrowthBook API 密钥或个人访问令牌（必需，敏感）
GB_API_URL：API 基础地址（可选，默认 https://api.growthbook.io）
GB_HTTP_HEADER_*：附加 HTTP 请求头（如 CF Access 令牌）

风险与副作用

growthbook_call_api 是通用直通工具，POST/PUT/PATCH/DELETE 可修改数据；工具描述仅为软性提示要求代理先与用户确认，并非硬性门槛
API 密钥为敏感凭据，泄露后可操作整个账户
HTTP 模式需在可信网络或回环地址运行；公网/多租户部署应由自建网关和认证前置

安装接入

准备工作

运行环境：Node.js · Docker

GB_API_KEY 必填密钥 GrowthBook API 密钥或个人访问令牌，在 GrowthBook 账户设置中生成，stdio 模式下必填。

其他可选配置项（7 个）

GB_API_URL 可选 GrowthBook API 地址，默认 https://api.growthbook.io，自托管时改成自己的域名。

GB_SKILLS_ENABLED 可选设为 false/0 可关闭内置 skill 工具（growthbook_list_skills、growthbook_read_skill），默认开启。

GB_MCP_TRANSPORT 可选传输方式，可选 stdio 或 http，默认 stdio。

GB_MCP_PORT 可选 HTTP 模式监听端口，默认 3333。

GB_MCP_HOST 可选 HTTP 模式绑定主机，默认 127.0.0.1。

GB_MCP_URL 可选 HTTP 模式下服务器的公网基础 URL，用于 OAuth 资源元数据，缺失时服务器拒绝启动。

GB_OAUTH_ISSUER 可选 GrowthBook OAuth 授权服务器 issuer 地址，默认取 GB_API_URL。

使用 npm 安装并构建（npm install && npm run build），然后将 MCP 客户端指向编译后的 server/index.js，或在客户端配置中使用 npx @growthbook/mcp。必须设置 GB_API_KEY（GrowthBook API 密钥或个人访问令牌），可选设置 GB_API_URL（默认 https://api.growthbook.io）。开发构建需要同级目录 ../skills 或 SKILLS_SRC 环境变量。也可拉取 ghcr.io/growthbook/growthbook-mcp 的多架构镜像。

MCP 配置 · JSON

{
  "mcpServers": {
    "growthbook": {
      "command": "npx",
      "args": [
        "@growthbook/mcp"
      ],
      "env": {
        "GB_API_KEY": "your_api_key_or_pat",
        "GB_API_URL": "https://api.growthbook.io"
      }
    }
  }
}

适用于使用 mcpServers 字段的客户端。VS Code 等使用其他字段的客户端，可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "growthbook": {
      "command": "npx",
      "args": [
        "@growthbook/mcp"
      ],
      "env": {
        "GB_API_KEY": "your_api_key_or_pat",
        "GB_API_URL": "https://api.growthbook.io"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add growthbook -e GB_API_KEY=your_api_key_or_pat -e GB_API_URL=https://api.growthbook.io -- npx @growthbook/mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端的工具列表中应看到 growthbook_list_skills、growthbook_read_skill 和 growthbook_call_api 三个工具；让 agent 调用 growthbook_call_api 执行 GET /api/v1/projects，能返回项目数据即说明连接与鉴权正常。

常见排障

401 invalid_token：检查 GB_API_KEY 是否有效，HTTP 模式下客户端应自动刷新令牌
403 表示令牌被接受但权限不足，而非令牌失效
自托管实例 404：确认 GB_API_URL 指向正确地址
HTTP 模式拒绝启动：必须设置 GB_MCP_URL
技能工具未出现：检查 GB_SKILLS_ENABLED 是否被设为 false/0

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出 GrowthBook 里所有可用的 agent skills。
读取创建 feature flag 的 skill，然后按其步骤新建一个名为 my-flag 的开关。
调用 API 获取 /api/v1/projects 下的项目列表。
帮我在项目里创建一个实验并查看现有实验结果。

工具能力 3

growthbook_list_skills 只读

列出内置的 GrowthBook 代理技能（名称与描述）

growthbook_read_skill 只读

返回完整技能 Markdown 内容（工作流程与防护准则）

growthbook_call_api 写入

向 GrowthBook API 发起已认证的 REST 直通调用，支持 GET/POST/PUT/PATCH/DELETE

使用场景

通过 AI 代理创建和管理功能开关

查询实验数据和项目信息

让代理遵循官方技能中的工作流程与防护准则

自托管 GrowthBook 实例的远程 MCP 接入（HTTP + OAuth 模式）

详细介绍

这是 GrowthBook 官方维护的轻量 MCP 服务器。它提供三个工具：列出和读取内置的 GrowthBook 代理技能（构建时从官方 skills 仓库打包），以及一个通用的 growthbook_call_api 工具，通过 REST 直通方式调用 GrowthBook API（支持功能开关创建、实验查询等）。支持 stdio 和带 OAuth 2.0 保护资源（RFC 9728 / RFC 6750）的 HTTP 传输模式，可按需禁用技能工具只保留 API 能力。