内容
# Wingify 功能实验 MCP 服务器
[](https://www.npmjs.com/package/wingify-fme-mcp)
[](http://www.apache.org/licenses/LICENSE-2.0)
## 概述
Wingify 功能实验 MCP 服务器使开发者能够在 AI 编程环境中轻松管理功能标志。通过将 Wingify 强大的功能管理平台与 AI 开发工具集成，它实现了功能标志的无缝创建、修改和控制，简化了工作流程并加速了功能交付。
有关产品和 SDK 文档，请参阅 [Wingify 功能实验概述](https://developers.wingify.com/v3/docs/fme-overview)。
<br>
> 您可以通过点击下面的按钮添加 Wingify 功能实验 MCP 服务器。在开始使用之前，请确保更新 `WINGIFY_ACCOUNT_ID` 和 `WINGIFY_API_KEY` 环境变量。
<a href="https://cursor.com/install-mcp?name=wingify-fme-mcp&config=eyJjb21tYW5kIjoibnB4IC15IHdpbmdpZnktZm1lLW1jcEBsYXRlc3QiLCJlbnYiOnsiV0lOR0lGWV9BQ0NPVU5UX0lEIjoiV0lOR0lGWV9BQ0NPVU5UX0lEIiwiV0lOR0lGWV9BUElfS0VZIjoiV0lOR0lGWV9BUElfS0VZIn19" target="_blank">
<img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="将 wingify-fme-mcp MCP 服务器添加到 Cursor" width="170" height="40" />
</a>
---
### 主要功能
- **无缝 AI 助手集成**：兼容 Cursor、VS Code 和 Claude
- **全面的功能标志管理**：轻松创建、查看、列出、更新和删除功能标志
- **环境特定控制**：在不同环境中切换功能开启或关闭
- **Cursor 规则设置**：引导简化 Cursor 规则配置，以提供上下文结果并与 SDK 集成
该工具帮助开发者节省时间，在编码过程中直接管理功能标志，无需在不同工具之间切换。
### 必需配置
要使用 MCP 服务器，您需要配置两个必填环境变量：
- `WINGIFY_ACCOUNT_ID`：您的 Wingify 账户 ID。
- `WINGIFY_API_KEY`：您的 Wingify API 密钥（开发者令牌），用于与 RESTful API 交互
这些凭证是身份验证和与 Wingify 功能管理系统的连接所必需的。
> **旧环境变量：** 如果未设置 `WINGIFY_*` 变量，则仍会读取 `VWO_ACCOUNT_ID`、`VWO_API_KEY` 和 `VWO_API_BASE_URL` 作为备用。
## 将 MCP 服务器连接到客户端
您可以在任何支持 MCP 协议的客户端上使用 Wingify 功能实验 MCP 服务器。以下是热门工具的逐步指南。请务必将 `WINGIFY_ACCOUNT_ID` 和 `WINGIFY_API_KEY` 替换为您的实际 Wingify 账户 ID 和 API 密钥。
### Cursor
1. 进入 **Cursor 设置** 并选择 **MCP** 部分。
2. 点击 **添加新的全局 MCP 服务器**。
3. 出现提示时，输入以下配置（请确保使用您的真实凭证）：
```json
{
"mcpServers": {
"wingify-fme": {
"command": "npx",
"args": ["-y", "wingify-fme-mcp@latest"],
"env": {
"WINGIFY_ACCOUNT_ID": "WINGIFY_ACCOUNT_ID",
"WINGIFY_API_KEY": "WINGIFY_API_KEY"
}
}
}
}
```
<img src="./assets/gifs/VWO_Cursor_MCP .gif" />
4. 保存更改。如果一切设置正确，您应该会看到一个绿色状态指示器，表明服务器已激活。
---
### VS Code
1. 在 VS Code 中打开 **用户设置（JSON）**。
2. 添加或更新以下 MCP 服务器配置：
```json
"mcp": {
"servers": {
"wingify-fme": {
"command": "npx",
"args": ["-y", "wingify-fme-mcp@latest"],
"env": {
"WINGIFY_ACCOUNT_ID": "WINGIFY_ACCOUNT_ID",
"WINGIFY_API_KEY": "WINGIFY_API_KEY"
}
}
}
}
```
<img src="./assets/gifs/VWO_VS_Code_MCP.gif" />
3. 保存设置文件。现在，MCP 服务器应该在 VS Code 中可用。
---
### Claude Desktop
1. 打开 **设置** 菜单并进入 **开发者** 部分。
2. 点击 **编辑配置** 以打开您的 `claude_desktop_config.json` 文件。
3. 在您的配置中添加以下块（用您的实际凭证替换占位符）：
```json
{
"mcpServers": {
"wingify-fme": {
"command": "npx",
"args": ["-y", "wingify-fme-mcp@latest"],
"env": {
"WINGIFY_ACCOUNT_ID": "WINGIFY_ACCOUNT_ID",
"WINGIFY_API_KEY": "WINGIFY_API_KEY"
}
}
}
}
```
4. 保存文件并重启 Claude Desktop。连接成功后，您应该会在聊天窗口中看到一个锤子图标，确认 MCP 服务器已激活。
<img src="./assets/gifs/VWO_Claude_MCP.gif" />
---
如果您使用不同的客户端，请参阅其文档，了解如何添加自定义 MCP 服务器。配置模式将与上述示例类似。
## 可用工具
以下是您可以使用我们的功能标志管理工具执行的操作：
### 与 Wingify 集成 IDE 配置
1. **添加 Wingify 功能实验规则** - 检索 IDE 规则和配置设置，以便在您的项目中无缝管理功能标志。这实现了与您的 SDK 的平滑集成，并利用了 Wingify 的功能管理功能。
📝**注意：** 支持 Cursor IDE 和 VS Code。工具会自动检测您的 IDE，也可以手动指定。需要在设置 Wingify 功能实验 MCP 服务器后调用一次。
- **Cursor IDE**：在 `.cursor/rules/wingify-feature-flag-rule.mdc` 中创建规则
- **VS Code**：在 `.github/instructions/wingify-fe.instructions.md` 中创建说明
### 功能标志
1. **创建具有默认值的功能标志** - 创建一个完整的功能标志，包含变量、变体、关联指标、规则和自动启用。此工具处理整个设置过程。
2. **创建功能标志** - 在您的 Wingify 账户中创建一个新的功能标志，包含变量、变体和指标等必填项。
3. **删除功能标志** - 当不再需要时，可以安全地删除您的账户中的任何功能标志。
4. **获取功能标志** - 查看任何功能标志的详细信息，了解其当前配置和状态。
5. **列出功能标志** - 在一个地方概览您的所有功能标志。
6. **更新功能标志** - 通过修改属性、指标和变体来微调您的功能标志。
7. **切换功能标志** - 在不同环境中一键启用或禁用功能标志。
8. **查找过时功能标志** - 通过扫描源代码并与活动功能标志进行比较，识别代码库中未使用的或过时的功能标志。这有助于通过查找不再在项目中引用的功能标志来保持代码清洁。
9. **集成 SDK** - 获取全面 SDK 集成文档和代码示例，以便在您的项目中无缝实施功能标志。此工具提供特定于语言的集成指南，无需 Cursor 规则文件。
### 功能标志规则
1. **列出功能标志规则** - 查看与您的功能标志关联的所有规则。
2. **创建推出和个性化规则** - 设置规则以逐步推出或个性化您的功能。
3. **创建测试和 MVT 规则** - 配置 A/B 测试或多变量测试的规则。
4. **获取功能标志规则** - 检查特定功能标志规则的详细信息。
5. **切换功能标志规则** - 启用或禁用功能标志的特定规则。
6. **更新功能标志规则** - 修改现有的功能标志规则以更改其配置或目标。
7. **删除功能标志规则** - 从您的功能标志中删除不需要的规则。
### 项目和环境
1. **列出项目和环境** - 查看您的所有项目及其关联环境。
### 指标
1. **获取指标** - 访问您的功能标志和实验的指标。
## 要求
- **Node.js v12 或更高版本**
### 版本历史
版本历史记录了每个版本的变化、改进和错误修复。有关完整的历史记录，请参阅 [CHANGELOG.md](https://github.com/wingify/wingify-fme-mcp/blob/master/CHANGELOG.md)。
## 开发和测试
### 安装依赖并引导 Git 钩子
```bash
npm install
# 或
yarn install
```
### 将 TypeScript 编译为 JavaScript
```bash
npm run build
# 或
yarn run build
```
## 贡献
我们欢迎为此 SDK 做出贡献！请在提交 PR 之前阅读我们的 [贡献指南](https://github.com/wingify/wingify-fme-mcp/blob/master/CONTRIBUTING.md)。
## 代码行为
我们的 [代码行为](https://github.com/wingify/wingify-fme-mcp/blob/master/CODE_OF_CONDUCT.md) 概述了对所有贡献者和维护者的期望。
## 许可证
[Apache License, Version 2.0](https://github.com/wingify/wingify-fme-mcp/blob/master/LICENSE)
版权 2025-2026 Wingify Software Pvt. Ltd.
