ConfigCat MCP Server 是 ConfigCat 官方发布的 Model Context Protocol(MCP)服务器,提供对 ConfigCat 公共管理 API 的访问,用于功能开关(Feature Flag)和配置管理。它还能让代码编辑器理解项目中的功能开关,将合适的 ConfigCat SDK 集成到项目中,甚至直接在代码库中创建新的功能开关。
主要能力
该服务器提供覆盖 ConfigCat 公共管理 API 的完整工具集,可对功能开关、配置、环境、产品等实体进行创建、读取、更新和删除操作。同时可获取全面的 SDK 文档与代码示例,便于在项目中实现功能开关。
可用工具涵盖多个类别:
成员管理:列出组织、组织成员、待处理邀请、产品成员,邀请成员、更新成员权限、删除组织成员、删除产品成员、取消邀请,以及权限组的列出、创建、获取、更新和删除。
产品与配置:列出产品、获取产品详情、更新产品、删除产品、获取与更新产品偏好、创建产品;列出配置、创建配置、获取配置详情、更新配置、删除配置。
环境与细分:列出环境、创建环境、获取环境详情、更新环境、删除环境;列出用户细分、创建细分、获取细分详情、更新细分、删除细分。
SDK 密钥与 Webhook:获取配置/环境的 SDK 密钥;列出 Webhook、获取 Webhook 详情、替换 Webhook 配置、更新 Webhook、删除 Webhook、获取 Webhook 签名密钥、创建 Webhook。
集成与审计:列出集成、创建集成、获取集成详情、更新集成、删除集成;获取代码引用;获取产品审计日志、组织审计日志;获取过期功能开关报告;获取组织当前用量与配额信息。
功能开关元数据:列出配置下的功能开关、创建功能开关、列出预定义变体、更新预定义变体、获取功能开关详情、替换功能开关配置、更新功能开关、删除功能开关;列出产品标签、创建标签、按标签获取功能开关、获取标签详情、更新标签、删除标签。
功能开关与设置值(v1 与 v2 API):获取功能开关值、更新功能开关值、替换功能开关值、获取多个设置值、更新多个设置值;上述工具提供适用于 Config V2 的 *-v2 版本。
变更请求:获取变更请求详情、更新变更请求元数据(如标题、备注、计划等)、列出变更请求、获取变更请求中提议的设置变更、更新提议的设置变更、添加评论、应用变更请求、批准变更请求、认领变更请求所有权、关闭变更请求(不应用)、为指定配置和环境创建变更请求、移除已有批准、解决因并发发布变更导致的设置冲突、更新已有评论、删除评论、从变更请求中移除某个设置。
SDK 文档:update-sdk-documentation 工具可获取全面的 SDK 文档与代码示例,便于在项目中实现功能开关。
使用方式
可通过环境变量配置该 MCP 服务器。连接客户端的方式如下:
Cursor:打开 Preferences -> Cursor Settings -> MCP & Integrations,点击 Add Custom MCP,添加 ConfigCat MCP 服务器的定义,然后保存设置。
Visual Studio Code:在项目根目录创建 .vscode/mcp.json 文件并写入相应内容,保存设置文件后,MCP 服务器即可在 VS Code 中使用。
Claude Desktop:打开 Settings → Developer,点击 Edit Config,打开 claude_desktop_config.json,保存并重启 Claude。
适用场景与限制
该服务器面向管理操作,适用于在代码编辑器中管理 ConfigCat 的功能开关、配置、环境、产品、成员、Webhook、集成、变更请求等,并获取 SDK 文档与代码示例。
需要注意:ConfigCat 公共 API 存在速率限制,服务器会遵守这些限制,并在超出限制时返回相应错误信息。该服务器仅设计用于管理操作,请勿在生产应用中用它评估功能开关值,评估应使用 ConfigCat SDK 或 ConfigCat Proxy。
支持与贡献
支持渠道为 https://configcat.com/support。欢迎贡献,更多信息请阅读贡献指南。