GrowthBook

官方

创建和读取功能标志、审查实验、生成标志类型、搜索文档，并与GrowthBook的功能标志和实验平台进行交互。

GitHub

你可以用 GrowthBook MCP 做什么？

发现可用工作流 — 让助手通过 growthbook_list_skills 列出 GrowthBook 技能入口点，以查看支持哪些任务。
加载分步指南 — 通过 growthbook_read_skill 请求特定工作流，如 feature-flags/references/flag-create，以获取带有防护措施的详细说明。
查询 GrowthBook 数据 — 让助手使用 growthbook_api_read 配合任何有效的 REST API 路径来获取项目、功能或其他资源。
修改 GrowthBook 资源 — 指示助手通过 growthbook_api_write 创建或更新标志，将 POST/PUT/PATCH/DELETE 调用映射到相同的 API 路径。

文档

GrowthBook MCP Thin

一个用于 GrowthBook 的轻量 MCP 服务器，提供四个工具：

工具	用途
`growthbook_list_skills`	列出顶级技能入口点（名称 + 描述）
`growthbook_read_skill`	返回列出的技能或限定的子工作流（`feature-flags` 或 `feature-flags/references/flag-create`）
`growthbook_api_read`	通过身份验证的 GET 透传到 GrowthBook API
`growthbook_api_write`	通过身份验证的 POST/PUT/PATCH/DELETE 透传

能力存在于 skills 仓库中，并在构建时打包。能力分为只读和写入 API 工具（没有按端点的格式化器），以便客户端能够正确遵循 readOnlyHint / destructiveHint。

工具以 growthbook_ 为前缀，以便在客户端加载多个 MCP 服务器时保持无歧义。

Cursor 插件

从 Cursor Marketplace 安装 GrowthBook。该插件将 Cursor 连接到位于 https://mcp.growthbook.io/mcp 的托管服务器；首次工具调用会打开 GrowthBook 登录以授权。自托管 GrowthBook 用户应按照下文所述手动配置服务器。

该插件由 .cursor-plugin/plugin.json 和 mcp.json 定义。要在本地测试更改，请将仓库复制到 ~/.cursor/plugins/local/growthbook 并运行 Developer: Reload Window。

安装 / 运行

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_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 基础 URL，写入 OAuth 资源元数据（服务器在 HTTP 模式下没有它将拒绝启动）
`GB_MCP_KEEP_ALIVE_TIMEOUT_MS`	否	`90000`	HTTP 模式下的空闲保活超时。必须超过前端任何负载均衡器的空闲超时，否则负载均衡器可能重用服务器已关闭的连接，请求将失败并返回 502
`OPENAI_APPS_CHALLENGE_TOKEN`	否	—	以纯文本形式在 `/.well-known/openai-apps-challenge` 提供，用于 OpenAI 插件域名验证（HTTP 模式）；未设置时路由返回 404
`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 模式

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 之前，服务器使用 bearer 令牌探测 GrowthBook REST（GET /api/v1/）。来自该探测（或稍后来自 API 工具）的 401 会产生 HTTP 401 和 error="invalid_token"，以便 MCP 客户端可以刷新——而不是将 "This API key has expired" 作为工具错误呈现。403 被视为已接受的 bearer（权限拒绝 ≠ 无效令牌），因此客户端不会被强制进入刷新循环。

仅能力模式

HTTP（推荐用于远程）： 将客户端指向 /mcp/api 而不是 /mcp：

{
  "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 / 进程级： 设置环境变量，使技能永远不会注册：

"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 从规范技能检出中复制顶级技能树，保留结构：

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

源路径解析：

SKILLS_SRC 环境变量（指向技能仓库根目录的路径）
agent-skills.local.json — { "path": "../skills" }，相对于仓库根目录。被 git 忽略；复制 agent-skills.local.json.example
skills-src/ — CI 和 Docker 构建所引用的内容

没有隐式的同级查找。../skills 解析为恰好位于该路径的任何内容，这会使本地构建与 CI 构建所基于的提交静默不一致。

CI、云部署和发布都读取 agent-skills.lock.json 并检出该确切的技能提交。要发布上游技能更改，请更新锁文件中的提交。本地开发可以使用 agent-skills.local.json 或 SKILLS_SRC 指向任何检出。

技能仓库保持为事实来源——此包不维护技能内容的分支。新技能会自动流入，除了 bundle-skills.mjs 中小的阻止列表中所列的名称。目前只有 gb-setup 被阻止，因为它配置了 gb-call shell 适配器而不是 GrowthBook 本身。

每个技能的 scripts/ 目录不会被复制。相对的 `references/foo.md` 链接会被重写为限定的 `feature-flags/references/foo` paths so 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\",...}" }

读取：仅 GET（readOnlyHint: true）
写入：POST | PUT | PATCH | DELETE（destructiveHint: true）
2xx 时返回原始响应体
非 2xx 时，返回可操作的错误（isError: true），涵盖认证失败、自托管 404 提示和速率限制
自由路径针对 GrowthBook REST API
每个请求都携带 MCP 使用情况头（参见使用遥测）

`growthbook_list_skills` / `growthbook_read_skill`

仅在 GB_SKILLS_ENABLED 未被禁用时注册。

growthbook_list_skills 返回顶级技能入口点。一个入口可能包含完整的工作流或路由到子工作流。
growthbook_read_skill 接受列出的顶级名称或由已加载技能命名的限定子路径（feature-flags/references/flag-create），并返回完整的 markdown（工作流 + 护栏）。

使用遥测

此服务器本身从不向任何地方发送遥测。相反，由 growthbook_api_read / growthbook_api_write 发出的每个 REST 调用都包含头，告诉它所通信的 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`	来自 initialize 握手的 MCP 客户端名称/版本，或其在 HTTP 模式下的 `User-Agent`

GrowthBook 通过其现有的产品遥测记录这些，因此相同的控制适用。在自托管实例上，在 GrowthBook 后端设置 DISABLE_TELEMETRY 会将其与 GrowthBook 的其他遥测一起关闭。较旧的 GrowthBook 版本会忽略这些头。技能工具（growthbook_list_skills / growthbook_read_skill）在本地提供且不发出请求，因此不会被跟踪。

开发

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（仅能力）处暴露 MCP，位于 OAuth 2.0 受保护资源表面之后（RFC 9728 元数据 + RFC 6750 WWW-Authenticate）。

GB_MCP_URL（HTTP 模式必需）— 服务器的公共基础 URL。它被写入 OAuth 资源（受众）和受保护资源元数据，因此永远不会从请求头派生。服务器没有它将拒绝启动。
GB_MCP_PORT（默认 3333）和 GB_MCP_HOST（默认 127.0.0.1）。
传入的 bearer 令牌通过探测 GrowthBook REST API 进行验证；被拒绝的令牌会收到 HTTP 401 + WWW-Authenticate，以便客户端可以刷新。

在受信任的网络或绑定到回环地址上运行。对于多租户或公共部署，请使用您自己的网关/认证作为前端。

发布

发布是有意为之的：在 package.json 中提升版本，运行 npm run sync-version（更新 manifest.json、server.json 和 .cursor-plugin/plugin.json），然后推送匹配的 v* 标签：

git tag v2.0.0
git push origin v2.0.0

该标签提交（技能在发布时冻结）发布：

@growthbook/mcp 到 npm — 预发布版本（带有 - 的版本，例如 2.0.0-beta.1）进入 beta dist-tag；稳定版本成为 latest
一个多架构（amd64 + arm64）镜像到 ghcr.io/growthbook/growthbook-mcp（:<version>，加上 :<major>、:<major>.<minor> 和 :latest 用于稳定版本）
MCP 注册表中的一个条目
一个 GitHub Release

Cursor 插件不由 CI 发布：Cursor 在版本提升落地后从默认分支重新审查插件。

使用 npx @growthbook/mcp@<version> 安装发布版本，或拉取 ghcr.io/growthbook/growthbook-mcp:<version>。