Unleash 特性标志 MCP 服务器

此仓库包含一个与 Unleash 特性标志管理系统交互的 Model Context Protocol (MCP) 服务器。它允许AI代理通过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的示例对话：

你：给我展示'dashboard'项目中的所有特性标志

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

Claude：这是'website'项目中的所有特性标志：
- new-homepage (类型：发布)
- dark-mode (类型：实验)
- beta-footer (类型：操作)
...

开发

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

npm run inspect

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

许可证

ISC