使用说明

项目简介

Flipt MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端,它使得 AI 助手能够与 Flipt 功能标志平台进行交互。通过此服务器,AI 助手可以方便地管理和利用 Flipt 上的功能标志,实现更智能化的功能控制和实验管理。

主要功能点

  • 功能标志管理: 支持对命名空间、标志、分段、规则等功能标志核心组件的全面管理,包括创建、更新、删除和列表查看等操作。
  • 功能标志评估: 允许 AI 助手根据实体 ID 和上下文信息评估功能标志的状态,从而实现基于特征的动态决策。
  • 功能标志控制: 提供开关切换功能标志的能力,便于 AI 助手根据需要实时调整功能上线状态。
  • 灵活配置: 支持约束、变体、分发和灰度发布等高级功能配置,满足多样化的功能标志管理需求。

安装步骤

根据您的偏好,选择以下任一方式安装 Flipt MCP 服务器:

Node.js 环境

  1. 确保您的系统已安装 Node.js 和 npm。
  2. 全局安装 '@flipt-io/mcp-server-flipt' 包:
    npm install -g @flipt-io/mcp-server-flipt

Docker 容器

  1. 确保您的系统已安装 Docker。
  2. 运行 Docker 命令下载并启动 Flipt MCP 服务器容器:
    docker run -d --name mcp-server-flipt ghcr.io/flipt-io/mcp-server-flipt:latest

服务器配置

要将 MCP 客户端连接到 Flipt MCP 服务器,您需要提供服务器的启动配置。以下是一个 JSON 格式的配置示例,适用于 MCP 客户端配置服务器连接:

{
  "serverName": "Flipt MCP Server",
  "command": "mcp-server-flipt",
  "args": []
}

配置参数说明:

  • 'serverName': MCP 服务器的名称,您可以自定义,用于在客户端标识该服务器。
  • 'command': 启动 MCP 服务器的命令。
    • 如果您使用 Node.js 全局安装,则命令为 'mcp-server-flipt'(请确保该命令已添加到您的系统 PATH 环境变量中)。
    • 如果您使用 Docker 容器,则命令为 'docker exec -it mcp-server-flipt mcp-server-flipt' (或者在Docker容器内部署并直接运行 'mcp-server-flipt'),但这通常不是直接连接的方式,更常见的是客户端直接连接宿主机暴露的端口。通常 Docker 部署 MCP 服务器后,客户端可以通过网络访问,而不是 exec 进入容器执行命令。对于本例,由于是 STDIO 传输,通常客户端和服务端在同一机器,直接 'mcp-server-flipt' 即可,Docker 方式更多用于部署和隔离。
  • 'args': 启动命令的可选参数,本例中没有额外参数。如果需要配置 Flipt API URL 或 API Key,可以通过环境变量 'FLIPT_API_URL' 和 'FLIPT_API_KEY' 进行设置,无需在启动参数中指定。

基本使用方法

  1. 启动服务器: 根据您的安装方式(Node.js 或 Docker)启动 Flipt MCP 服务器。
  2. 配置 MCP 客户端: 在您的 MCP 客户端(如 AI 助手应用)中,配置服务器连接信息,使用上面提供的 JSON 配置。
  3. 通过 AI 助手交互: 使用支持 MCP 的 AI 助手,通过自然语言指令调用 Flipt MCP 服务器提供的工具和 Prompt,管理和查询 Flipt 功能标志。例如,您可以指示 AI 助手创建新的功能标志、评估用户是否符合特定功能标志的条件、或者动态调整功能标志的开关状态。

环境变量配置

Flipt MCP 服务器支持以下环境变量配置,您可以在运行服务器前设置这些环境变量,例如在 '.env' 文件中配置:

  • 'FLIPT_API_URL': Flipt API 的 URL,默认为 'http://localhost:8080'。
  • 'FLIPT_API_KEY': 访问 Flipt API 的 API 密钥(可选)。

信息

分类

AI与计算