ConfigCat

官方

与ConfigCat功能标志平台交互。支持管理功能标志、配置、环境、产品和组织。帮助集成ConfigCat SDK、实现功能标志或移除僵尸(过期)标志。

你可以用 ConfigCat MCP 做什么?

  • 管理功能标志 — 在 ConfigCat 配置中创建、读取、更新、替换或删除功能标志及其设置。
  • 管理产品和环境 — 列出、创建、更新或删除产品、配置、环境和分段。
  • 处理变更请求 — 为配置和环境创建、列出、批准、应用、关闭或评论变更请求。
  • 获取 SDK 文档 — 获取 SDK 文档和代码示例,以便将 ConfigCat 功能标志集成到项目中。
  • 查看诊断信息 — 列出审计日志、获取过期功能标志报告,并检查组织用量和配额。
  • 管理成员和 Webhook — 邀请成员、更新权限组,以及创建、更新或删除 Webhook。

文档

ConfigCat MCP Server

NPM License

ConfigCat 的模型上下文协议 (MCP) 服务器可访问 ConfigCat 的公共管理 API,用于功能标志和配置管理。它还可以让代码编辑器理解您的功能标志,将相应的 ConfigCat SDK 集成到您的项目中,甚至直接在代码库中创建新的功能标志。

功能

  • 工具:
    • 提供一整套用于操作 ConfigCat 公共管理 API 的工具。您可以在 ConfigCat 中创建、读取、更新和删除各种实体,例如功能标志、配置、环境或产品。
    • 获取全面的 SDK 文档和代码示例,以便在项目中顺利实现功能标志。

设置

您可以使用以下环境变量配置 MCP 服务器。

环境变量必填默认值说明
CONFIGCAT_API_USER☑ConfigCat Management API 基本身份验证用户名。
CONFIGCAT_API_PASS☑ConfigCat Management API 基本身份验证密码。
CONFIGCAT_BASE_URLhttps://api.configcat.comConfigCat Management API 主机。

以下说明展示了如何将客户端连接到 MCP 服务器。

Cursor

  1. 打开 Preferences -> Cursor Settings -> MCP & Integrations
  2. 点击 Add Custom MCP
  3. 添加以下 ConfigCat MCP 服务器定义:
{
  "mcpServers": {
    "ConfigCat": {
      "command": "npx",
      "args": ["-y", "@configcat/mcp-server"],
      "env": {
        "CONFIGCAT_API_USER": "YOUR_API_USER",
        "CONFIGCAT_API_PASS": "YOUR_API_PASSWORD"
      }
    }
  }
}
  1. 保存设置。

Visual Studio Code

  1. 在项目根目录中创建一个 .vscode/mcp.json 文件,并添加以下内容:
{
  "servers": {
    "ConfigCat": {
      "command": "npx",
      "args": ["-y", "@configcat/mcp-server"],
      "env": {
        "CONFIGCAT_API_USER": "YOUR_API_USER",
        "CONFIGCAT_API_PASS": "YOUR_API_PASSWORD"
      }
    }
  }
}
  1. 保存设置文件。现在,MCP 服务器应该已可在 VS Code 中使用。

Claude Desktop

  1. 打开 设置 → 开发者
  2. 点击 编辑配置
  3. 打开 claude_desktop_config.json
  4. 添加以下 ConfigCat MCP 服务器定义:
{
  "mcpServers": {
    "ConfigCat": {
      "command": "npx",
      "args": ["-y", "@configcat/mcp-server"],
      "env": {
        "CONFIGCAT_API_USER": "YOUR_API_USER",
        "CONFIGCAT_API_PASS": "YOUR_API_PASSWORD"
      }
    }
  }
}
  1. 保存并重启 Claude。

可用工具

成员管理

组织

  • list-organizations - 列出所有组织

成员

  • list-organization-members - 列出组织成员
  • list-pending-invitations - 列出待处理的邀请
  • list-pending-invitations-org - 列出组织待处理的邀请
  • list-product-members - 列出产品成员
  • invite-member - 邀请新成员
  • update-member-permissions - 更新成员权限
  • delete-organization-member - 移除组织成员
  • delete-product-member - 移除产品成员
  • delete-invitation - 取消邀请

权限组

  • list-permission-groups - 列出权限组
  • create-permission-group - 创建新的权限组
  • get-permission-group - 获取权限组详情
  • update-permission-group - 更新权限组
  • delete-permission-group - 删除权限组

常规

产品

  • list-products - 列出所有产品
  • get-product - 获取指定产品的详情
  • update-product - 更新现有产品
  • delete-product - 删除产品
  • get-product-preferences - 获取产品偏好设置
  • update-product-preferences - 更新产品偏好设置
  • create-product - 创建新产品

配置

  • list-configs - 列出产品的配置
  • create-config - 创建新配置
  • get-config - 获取指定配置的详情
  • update-config - 更新现有配置
  • delete-config - 删除配置

环境

  • list-environments - 列出产品的环境
  • create-environment - 创建新环境
  • get-environment - 获取指定环境的详情
  • update-environment - 更新现有环境
  • delete-environment - 删除环境

细分群体

  • list-segments - 列出用户细分群体
  • create-segment - 创建新的细分群体
  • get-segment - 获取指定细分群体的详情
  • update-segment - 更新现有细分群体
  • delete-segment - 删除细分群体

SDK 密钥

  • get-sdk-keys - 获取配置/环境的 SDK 密钥

Webhook

  • list-webhooks - 列出 Webhook
  • get-webhook - 获取 Webhook 详情
  • replace-webhook - 替换 Webhook 配置
  • update-webhook - 更新现有 Webhook
  • delete-webhook - 删除 Webhook
  • get-webhook-signing-keys - 列出 Webhook 签名密钥
  • create-webhook - 创建新的 Webhook

集成

  • list-integrations - 列出集成
  • create-integration - 创建新的集成
  • get-integration - 获取集成详情
  • update-integration - 更新现有集成
  • delete-integration - 删除集成

代码引用

  • get-code-references - 获取代码引用

诊断

审计日志

  • list-auditlogs - 获取产品审计日志
  • list-organization-auditlogs - 获取组织审计日志

僵尸(过时)标志

  • list-staleflags - 获取过时功能标志报告

用量与配额

  • get-organization-usage-and-quota - 获取组织当前的用量和配额信息

功能标志元数据

功能标志与设置

  • list-settings - 列出配置的功能标志
  • create-setting - 创建新的功能标志
  • list-predefined-variations - 列出预定义变体
  • update-predefined-variations - 更新预定义变体
  • get-setting - 获取指定功能标志的详情
  • replace-setting - 替换功能标志配置
  • update-setting - 更新现有功能标志
  • delete-setting - 删除功能标志

标签

  • list-tags - 列出产品的标签
  • create-tag - 创建新标签
  • list-settings-by-tag - 按标签获取功能标志
  • get-tag - 获取指定标签的详情
  • update-tag - 更新现有标签
  • delete-tag - 删除标签

功能标志与设置值(v1 和 v2 API)

  • get-setting-value - 获取功能标志值
  • update-setting-value - 更新功能标志值
  • replace-setting-value - 替换功能标志值
  • get-setting-values - 获取多个设置值
  • post-setting-values - 更新多个设置值
  • V2 变体:*-v2 是上述工具适用于 Config V2 的版本

变更请求

  • get-change-request - 返回指定变更请求的详情
  • update-change-request - 更新变更请求的元数据,例如标题、备注、计划等
  • list-change-requests - 列出变更请求
  • get-change-request-proposed-changes - 返回变更请求中包含的设置的拟议更改
  • update-change-request-proposed-change - 更新变更请求中包含的设置的拟议更改
  • add-change-request-comment - 向变更请求添加新评论
  • apply-change-request - 应用变更请求
  • approve-change-request - 批准变更请求
  • claim-change-request-ownership - 声明变更请求的所有权
  • close-change-request - 关闭变更请求,但不应用它
  • create-change-request - 为指定的配置和环境创建新的变更请求
  • remove-change-request-approval - 撤销您对变更请求的现有批准
  • resolve-change-request-setting-conflicts - 更新变更请求中某项设置的拟议更改,以解决并发发布更改导致的冲突
  • update-change-request-comment - 更新现有的变更请求评论
  • delete-change-request-comment - 删除变更请求评论
  • delete-change-request-proposed-change - 从变更请求中移除设置

SDK 文档

  • get-sdk-documentation - 获取全面的 SDK 文档和代码示例,以便在项目中顺利实现功能标志。

API 速率限制

ConfigCat 公共 API 设有速率限制。服务器会遵守这些限制,并在超出限制时返回相应的错误消息。

安全说明

此服务器仅用于管理操作。请勿在生产应用程序中使用它来评估功能标志值;请改用 ConfigCat SDKs 或 ConfigCat Proxy。

需要帮助?

https://configcat.com/support

贡献

欢迎贡献。更多信息请阅读贡献指南。

关于 ConfigCat