Unleash Ff MCP Server

🚀 解放功能开关 MCP 服务器

本项目提供了一个模型上下文协议（MCP）服务器，用于和 Unleash 特性管理系统进行交互。借助该服务器，AI 代理能够通过 Unleash API 对特性开关进行管理，为 AI 模型与外部工具的交互提供了便利。

🚀 快速开始

本服务器实现了 MCP 协议的 Unleash 版本，让 AI 助手可以通过编程方式管理特性开关。下面为你介绍具体的安装、配置和使用方法。

📦 安装指南

你可以选择从 npm 全局安装该包，也可以直接使用 npx 运行：

npm install -g @ylin6/unleash-ff-mcp-server

或者

npx @ylin6/unleash-ff-mcp-server

🔧 配置说明

服务器运行需要设置以下环境变量：

• UNLEASH_API_URL：你的 Unleash API 实例的 URL
• UNLEASH_AUTH_TOKEN：你的 Unleash 实例的身份验证令牌

✨ 主要特性

MCP 服务器提供了一系列用于管理特性开关的实用工具：

获取项目

可检索 Unleash 实例中的所有项目。

获取特性

能在特定项目中检索所有特性标志。 参数：

• projectId：项目的 ID

创建特性标志

可在项目中创建新的特性标志。 参数：

• projectId：项目的 ID
• name：特性的名称
• description：特性的描述
• type：特性的类型（例如，“发布”，“实验”，“运营”，“杀死”）

更新特性标志

用于更新现有的特性标志。 参数：

• projectId：项目的 ID
• featureId：特性的 ID
• description：新的描述
• type：新的类型

获取特性标志

可检索特定特性标志的详细信息。 参数：

• projectId：项目的 ID
• featureId：特性的 ID

💻 使用示例

与 Cursor 配合使用

若要在 Cursor 中使用此 MCP 服务器，请在 Cursor 设置中使用以下命令：

env UNLEASH_API_URL=XXXX UNLEASH_AUTH_TOKEN=XXX npx -y @ylin6/unleash-ff-mcp-server

与 Cursor/Claude 的对话示例

您：让我看看 'dashboard' 项目中的所有特性标志。

Claude：我将为您获取 'dashboard' 项目中的所有特性标志。
[Claude 使用 getFeatures 工具，projectId='dashboard']

Claude：以下是 'website' 项目中所有特性标志：
- new-homepage（类型：发布）
- dark-mode（类型：实验）
- beta-footer（类型：运营）
...

🔧 技术细节

若要检查 MCP 服务器的操作，可以运行以下命令：

npm run inspect

此命令会使用 MCP 检查器来分析请求/响应模式。

📄 许可证

本项目采用 ISC 许可证。