增长手册 细
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_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 模式
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"
}
}
}
| 路径 | 工具 |
|---|---|
/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 从 canonial 技能检查复制顶级技能树, 保存结构 :
skills/<skill>/SKILL.md → server/skills/<skill>/SKILL.md
skills/<skill>/references/<workflow>.md → server/skills/<skill>/references/<workflow>.md
源路径解析度 :
SKILLS_SRCenv var (通过技能回波根)agent-skills.local.json—— 说{ "path": "../skills" },相对于 repo 根。 吉吉诺已忽略; 副本agent-skills.local.json.exampleskills-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-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)在当地服务,不提出请求,所以没有跟踪.
发展
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下潜betaditt-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>。 。 。 .