项目简介
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服务评估该标志,并返回结果及相关元数据。
信息
分类
开发者工具