Unleash Ff MCP Server

🚀 解放功能开关 MCP 服务器

本项目提供了一个模型上下文协议 (MCP) 服务器，旨在与 Unleash 特性管理系统进行交互。借助该服务器，AI 代理能够通过 Unleash API 便捷地管理特性开关，为 AI 应用的特性管理提供了高效的解决方案。

🚀 快速开始

此仓库包含的模型上下文协议 (MCP) 服务器，可让 AI 代理通过 Unleash API 管理特性开关。您可以按照以下步骤快速开启使用。

✨ 主要特性

• MCP 协议实现：模型上下文协议 (MCP) 是一种规范，用于使 AI 模型能够与其外部工具和数据源进行交互。此服务器实现了 MCP 协议的 Unleash 版本，让 AI 助手能够以编程方式管理特性开关。
• 丰富的工具支持：提供了用于管理特性开关的各种工具，如获取项目、获取特性、创建特性标志、更新特性标志和获取特性标志详细信息等。

📦 安装指南

您可以通过以下两种方式安装和运行该服务器：

从 npm 安装包

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

使用 npx 直接运行

npx @ylin6/unleash-ff-mcp-server

🔧 配置说明

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

💻 使用示例

基础用法

与 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 检查器来分析请求/响应模式。

📚 详细文档

可用工具说明

MCP 服务器提供了用于管理特性开关的各种工具，具体如下：

获取项目

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

获取特性

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

• projectId：项目的 ID

创建特性标志

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

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

更新特性标志

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

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

获取特性标志

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

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

📄 许可证

本项目采用 ISC 许可证。