Unleash Feature Flag MCP Server

Unleash 功能标志 MCP 服务

此仓库包含一个 Model Context Protocol（MCP）服务，用于与 Unleash 功能标志管理系统交互。它允许 AI Agent 通过 Unleash API 管理功能标志。

什么是 MCP？

Model Context Protocol（MCP）是一项规范，旨在让 AI 模型能够与外部工具和数据源交互。此服务为 Unleash 实现了 MCP 协议，使 AI 助手能够以编程方式管理功能标志。

安装

你可以从 npm 安装此软件包：

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

也可以使用 npx 直接运行：

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：功能标志的类型（例如，“release”“experiment”“operational”“kill-switch”）

更新功能标志

更新现有的功能标志。

参数：

• projectId：项目的 ID
• featureId：功能标志的 ID
• description：功能标志的新描述
• type：功能标志的新类型

获取功能标志

获取指定功能标志的详细信息。

参数：

• projectId：项目的 ID
• featureId：功能标志的 ID

与 Cursor 配合使用

要将此 MCP 服务与 Cursor 配合使用，请在 Cursor 设置中使用以下命令：

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

示例

与 Cursor/Claude 的对话示例：

You: Show me all the feature flags in the 'dashboard' project

Claude: I'll fetch all the feature flags in the 'dashboard' project for you.
[Claude uses the getFeatures tool with projectId='dashboard']

Claude: Here are all the feature flags in the 'website' project:
- new-homepage (type: release)
- dark-mode (type: experiment)
- beta-footer (type: operational)
...

开发

要检查 MCP 服务的操作，可以运行：

npm run inspect

这会使用 MCP 检查器分析请求/响应模式。

许可证

ISC