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 許可證。