项目简介

OpenFeature MCP 服务器是一个本地运行的工具,旨在将AI编程助手(如Cursor、Claude Code、VS Code等)与OpenFeature的功能连接起来。它作为一个桥梁,让AI助手能够访问OpenFeature的特性标志管理能力,提供智能代码生成、迁移、SDK安装指导和特性标志评估等服务,从而简化开发流程。

主要功能点

  • SDK安装指导: AI助手可以请求特定语言或框架的OpenFeature SDK安装说明,并选择包含特定提供商的配置文档。
  • 特性标志评估: AI助手能够通过OpenFeature远程评估协议 (OFREP) 评估特性标志的值,支持单标志和批量评估,并处理上下文信息。
  • 文档资源管理: AI助手可以按需获取OpenFeature提供商的官方文档,方便集成和学习。
  • 标准化通信: 通过Model Context Protocol (MCP) 标准协议与AI助手进行通信,确保互操作性。

安装步骤

OpenFeature MCP 服务器可以通过'npx'或全局'npm'安装方式使用。

  • 使用NPX(无需安装,直接运行): 这是推荐的简单方式,无需预先安装。 在您的AI助手的MCP配置中,指定执行'npx'命令来启动服务器。
  • 全局NPM安装: 打开终端并执行以下命令进行全局安装: 'npm install -g @openfeature/mcp' 安装完成后,在您的AI助手的MCP配置中,指定执行'openfeature-mcp'命令来启动服务器。

服务器配置

MCP服务器需要被配置到AI助手的'mcpServers'设置中,以便AI助手能够发现并连接它。以下是常见的配置示例:

配置示例 (JSON格式):

{
  "mcpServers": {
    "OpenFeature": {
      "command": "npx",
      "args": ["-y", "@openfeature/mcp"]
    }
  }
}
  • 'OpenFeature': 这是您为该MCP服务器定义的名称,AI助手将使用此名称来引用它。
  • 'command': 指定启动MCP服务器的命令。这里使用了'npx',它会自动下载并运行'@openfeature/mcp'包。如果您是全局安装的,这里应为'openfeature-mcp'。
  • 'args': 传递给'command'的参数列表。对于'npx'方式,'-y'表示自动确认安装,'@openfeature/mcp'是指定要运行的npm包。

OFREP 配置 (可选): 如果需要使用特性标志评估功能,您可能需要配置OFREP服务的URL和认证信息。这些可以通过环境变量或配置文件'~/.openfeature-mcp.json'进行设置。

  • 环境变量:

    • 'OPENFEATURE_OFREP_BASE_URL' 或 'OFREP_BASE_URL': 您的OFREP服务的基础URL。
    • 'OPENFEATURE_OFREP_BEARER_TOKEN' 或 'OFREP_BEARER_TOKEN': 用于认证的Bearer Token。
    • 'OPENFEATURE_OFREP_API_KEY' 或 'OFREP_API_KEY': 用于认证的API Key。
  • 配置文件 '~/.openfeature-mcp.json' 示例:

    {
      "OFREP": {
        "baseUrl": "https://flags.your-domain.com",
        "bearerToken": "your_bearer_token"
      }
    }

基本使用方法

一旦OpenFeature MCP服务器被您的AI编程助手配置并连接成功,您就可以通过自然的语言命令来利用其功能。

  • 请求SDK安装指南: 向AI助手提问:“请为Node.js安装OpenFeature SDK,并使用flagd提供商。” AI助手将调用MCP服务器的'install_openfeature_sdk'工具,获取并提供相关的安装说明。

  • 评估特性标志: 向AI助手提问:“你能帮我检查'new-checkout-flow'特性标志对于'user-123'的值吗?” AI助手将调用MCP服务器的'ofrep_flag_eval'工具,通过OFREP服务评估该标志,并返回结果及相关元数据。

信息

分类

开发者工具