释放 MCP 服务器

与 Unleash Feature Toggle 系统集成的模型上下文协议 (MCP) 服务器实现。

概述

该项目使用模型上下文协议 (MCP) 在 LLM 应用程序和 Unleash 功能标记系统之间搭建了桥梁。它允许 AI 应用程序：

从 Unleash 检查功能标志状态
向 LLM 公开功能标志信息
创建功能标志
更新功能标志
列出所有项目

要求

Node.js（v18 或更高版本）
TypeScript（v5.0 或更高版本）
访问 Unleash 服务器实例

安装

# Install dependencies
npm i

建筑学

Unleash MCP 服务器充当 LLM 应用程序和 Unleash 功能标志系统之间的桥梁：

+----------------+      +-------------------+      +----------------+
|                |      |                   |      |                |
|  LLM App       | <--> |  Unleash MCP      | <--> |  Unleash API   |
|  (MCP Client)  |      |  Server           |      |  Server        |
|                |      |                   |      |                |
+----------------+      +-------------------+      +----------------+

发展

项目结构

unleash-mcp-server/
├── src/
│   ├── index.ts              # Main entry point
│   ├── server.ts             # Server implementation
│   ├── config.ts             # Configuration handling
│   ├── transport/            # MCP transport implementations
│   │   ├── http.ts           # HTTP/SSE transport
│   │   └── stdio.ts          # STDIO transport
│   ├── unleash/              # Unleash API client implementations
│   │   ├── unleash-client.ts # Main Unleash client
│   │   ├── get-feature-flag.ts
│   │   └── get-all-projects.ts
│   ├── resources/            # MCP resource implementations
│   │   ├── flags.ts          # Feature flag resources
│   │   └── projects.ts       # Project resources
│   ├── tools/                # MCP tool implementations
│   │   ├── get-flag.ts       # Get feature flag tool
│   │   └── get-projects.ts   # Get projects tool
│   └── prompts/              # MCP prompt implementations
│       ├── flag-check.ts     # Check single flag
│       └── batch-flag-check.ts # Check multiple flags
├── tests/                    # Tests
└── package.json              # Project configuration

编码标准

命名约定：
- 文件：使用 kebab-case.ts （例如feature-flag.ts ）
- 类：使用 PascalCase（例如， UnleashClient ）
- 函数/方法：使用驼峰式命名法（例如getFlagStatus ）
- 接口/类型：使用 PascalCase（例如， FeatureFlagConfig ）
进口：
- 导入本地文件时始终包含 .js 扩展名
- 遵循导入顺序：Node.js 内置函数 → 外部依赖项 → 本地导入
- 使用命名导出而不是默认导出
文档：
- 对公共函数、类和接口使用 JSDoc 注释
- 使用内联注释记录复杂逻辑

建筑

# Compile TypeScript
npm run build

# Run the server
npm start

测试

# Run tests
npm test

检查

# MCP stdio inspect
npm run build
npx @modelcontextprotocol/inspector node dist/index.js

# MCP sse inspect
npm start
npx @modelcontextprotocol/inspector

如何使用

对于 Claude 或 Cursor 配置：

{
  "mcpServers": {
    "unleash": {
      "command": "npx",
      "args": [
        "-y",
        "unleash-mcp"
      ],
      "env": {
        "UNLEASH_URL": "YOUR_UNLEASH_END_POINT",
        "UNLEASH_API_TOKEN": "YOUR_UNLEASH_API_TOKEN",
        "MCP_TRANSPORT": "stdio",
        "MCP_HTTP_PORT": 3001
      }
    }
  }
}

贡献

欢迎贡献代码！欢迎提交 Pull 请求。

支持该项目

如果您发现这个项目有帮助，请考虑给我买杯咖啡！

扫描上方二维码或点击此处支持该项目的发展。

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

Unleash MCP (Feature Toggle)

Integrations

释放 MCP 服务器

概述

目录

要求

安装

建筑学

发展

项目结构

编码标准

建筑

测试

检查

如何使用

贡献

支持该项目

执照

Tools

Related Resources