适合谁
- 已使用 GrowthBook 并希望用 AI 代理管理开关与实验的团队
- 需要已认证、可审计 API 直通的 MCP 用户
- 自托管实例运维人员
G
60FMRS · C
官方维护的轻量 GrowthBook MCP 服务器，设计精简：技能内容在构建时打包、能力层是单一通用 API 直通工具，凭统一前缀避免多服务器混淆。HTTP 模式的 OAuth 与令牌刷新处理较为完善。适合已有 GrowthBook 的团队，但修改性调用依赖软性确认，需谨慎授权。
这是 GrowthBook 官方维护的轻量 MCP 服务器。它提供三个工具：列出和读取内置的 GrowthBook 代理技能（构建时从官方 skills 仓库打包），以及一个通用的 growthbook_call_api 工具，通过 REST 直通方式调用 GrowthBook API（支持功能开关创建、实验查询等）。支持 stdio 和带 OAuth 2.0 保护资源（RFC 9728 / RFC 6750）的 HTTP 传输模式，可按需禁用技能工具只保留 API 能力。
工具能力
growthbook_list_skills
列出内置的 GrowthBook 代理技能（名称与描述）
growthbook_read_skill
返回完整技能 Markdown 内容（工作流程与防护准则）
growthbook_call_api
向 GrowthBook API 发起已认证的 REST 直通调用，支持 GET/POST/PUT/PATCH/DELETE
安装接入
使用 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 的多架构镜像。
claude_desktop_config.json
{
"mcpServers": {
"growthbook": {
"command": "npx",
"args": [
"@growthbook/mcp"
],
"env": {
"GB_API_KEY": "your_api_key_or_pat",
"GB_API_URL": "https://api.growthbook.io"
}
}
}
}
选型与风险
不适合谁
- 未使用 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 模式需在可信网络或回环地址运行；公网/多租户部署应由自建网关和认证前置
常见排障
- 401 invalid_token：检查 GB_API_KEY 是否有效，HTTP 模式下客户端应自动刷新令牌
- 403 表示令牌被接受但权限不足，而非令牌失效
- 自托管实例 404：确认 GB_API_URL 指向正确地址
- HTTP 模式拒绝启动：必须设置 GB_MCP_URL
- 技能工具未出现：检查 GB_SKILLS_ENABLED 是否被设为 false/0
使用场景
通过 AI 代理创建和管理功能开关
查询实验数据和项目信息
让代理遵循官方技能中的工作流程与防护准则
自托管 GrowthBook 实例的远程 MCP 接入（HTTP + OAuth 模式）