释放 MCP 服务器

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

概述

本项目提供了一个 LLM 应用和 Unleash 特性开关系统之间的桥梁，使用模型上下文协议 (MCP)。它允许 AI 应用：

1. 从 Unleash 检查特性开关状态
2. 向 LLM 公开特性开关信息
3. 创建特性开关
4. 更新特性开关
5. 列出所有项目

目录

• 要求
• 安装
• 架构
• 配置
• 开发
• 贡献
• 许可

要求

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

安装

# 安装依赖
npm i

架构

Unleash MCP 服务器充当 LLM 应用和 Unleash 特性开关系统之间的桥梁：

+----------------+      +-------------------+      +----------------+
|                |      |                   |      |                |
|  LLM 应用       | <--> |  Unleash MCP      | <--> |  Unleash API   |
|  (MCP 客户端)  |      |  服务器           |      |  服务器        |
|                |      |                   |      |                |
+----------------+      +-------------------+      +----------------+

开发

项目结构

unleash-mcp-server/
├── src/
│   ├── index.ts              # 主入口点
│   ├── server.ts             # 服务器实现
│   ├── config.ts             # 配置处理
│   ├── transport/            # MCP 传输实现
│   │   ├── http.ts           # HTTP/SSE 传输
│   │   └── stdio.ts          # STDIO 传输
│   ├── unleash/              # Unleash API 客户端实现
│   │   ├── unleash-client.ts # 主要 Unleash 客户端
│   │   ├── get-feature-flag.ts
│   │   └── get-all-projects.ts
│   ├── resources/            # MCP 资源实现
│   │   ├── flags.ts          # 特性开关资源
│   │   └── projects.ts       # 项目资源
│   ├── tools/                # MCP 工具实现
│   │   ├── get-flag.ts       # 获取特性开关工具
│   │   └── get-projects.ts   # 获取项目工具
│   └── prompts/              # MCP 提示实现
│       ├── flag-check.ts     # 检查单个开关
│       └── batch-flag-check.ts # 检查多个开关
├── tests/                    # 测试
└── package.json              # 项目配置

编码规范

• 命名约定:

  • 文件: 使用 kebab-case.ts (例如, feature-flag.ts)
  • 类: 使用 PascalCase (例如, UnleashClient)
  • 函数/方法: 使用 camelCase (例如, getFlagStatus)
  • 接口/类型: 使用 PascalCase (例如, FeatureFlagConfig)

• 导入:

  • 导入本地文件时始终包含 .js 扩展名
  • 遵循导入顺序: Node.js 内置模块 → 外部依赖 → 本地导入
  • 使用命名导出而不是默认导出

• 文档:

  • 对公共函数、类和接口使用 JSDoc 注释
  • 使用内联注释记录复杂逻辑

构建

# 编译 TypeScript
npm run build

# 运行服务器
npm start

测试

# 运行测试
npm test

检查

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

# MCP sse 检查
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 Request。

支持项目

如果您觉得这个项目有帮助，请考虑请我喝杯咖啡！

<p align="center"> <img src="https://raw.githubusercontent.com/cuongtl1992/mcp-dbs/main/assets/bmc_qr.png" alt="Buy Me A Coffee QR Code" width="200"> </p>

扫描上面的二维码或点击这里来支持这个项目的开发。

许可

本项目基于 MIT 许可 - 详情请查看 LICENSE 文件。