Unleash Integration (Feature Toggle)

What is unleash-mcp?

unleash-mcp is a Model Context Protocol (MCP) server implementation designed to integrate with the Unleash Feature Toggle system. It acts as a bridge, allowing Large Language Model (LLM) applications to interact with Unleash feature flags.

How to use unleash-mcp?

To use unleash-mcp, you need Node.js (v18+) and TypeScript (v5.0+), along with access to an Unleash server instance. Installation involves npm i. For integration with LLM applications like Claude or Cursor, you configure the mcpServers in a JSON file, providing the command to run unleash-mcp and environment variables for your Unleash URL, API token, and MCP transport settings.

Key Features of unleash-mcp

• Feature Flag Management: Check, create, and update feature flags in Unleash.
• LLM Integration: Expose feature flag information directly to LLMs.
• Project Listing: List all projects within your Unleash instance.
• Multiple Transports: Supports HTTP/SSE and STDIO transports for MCP communication.

Use Cases of unleash-mcp

• Dynamic AI Behavior: LLM applications can dynamically adjust their behavior based on feature flag statuses, enabling A/B testing or gradual rollout of new AI features.
• Contextual AI Responses: Provide LLMs with real-time feature flag information to generate more contextually aware responses.
• Automated Feature Control: Allow AI systems to programmatically manage feature flags within Unleash.

FAQ about unleash-mcp

Q: What are the main requirements for running unleash-mcp? A: You need Node.js (v18 or higher), TypeScript (v5.0 or higher), and access to an Unleash server instance.

Q: How does unleash-mcp connect to LLM applications? A: unleash-mcp uses the Model Context Protocol (MCP) to communicate with LLM applications, acting as a server that LLM clients can interact with.

Q: Can unleash-mcp create new feature flags? A: Yes, unleash-mcp supports creating new feature flags within the Unleash system.

Unleash MCP Server

A Model Context Protocol (MCP) server implementation that integrates with Unleash Feature Toggle system.

Overview

This project provides a bridge between LLM applications and Unleash feature flag system using the Model Context Protocol (MCP). It allows AI applications to:

1. Check feature flag status from Unleash
2. Expose feature flag information to LLMs
3. Create feature flag
4. Update feature flag
5. List all projects

Table of Contents

• Requirements
• Installation
• Architecture
• Configuration
• Development
• Contributing
• License

Requirements

• Node.js (v18 or higher)
• TypeScript (v5.0 or higher)
• Access to an Unleash server instance

Installation

# Install dependencies
npm i

Architecture

The Unleash MCP Server acts as a bridge between LLM applications and the Unleash feature flag system:

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

Development

Project Structure

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

Coding Standards

• Naming Conventions:

  • Files: Use kebab-case.ts (e.g., feature-flag.ts)
  • Classes: Use PascalCase (e.g., UnleashClient)
  • Functions/Methods: Use camelCase (e.g., getFlagStatus)
  • Interfaces/Types: Use PascalCase (e.g., FeatureFlagConfig)

• Imports:

  • Always include .js extension when importing local files
  • Follow import ordering: Node.js built-ins → External dependencies → Local imports
  • Use named exports over default exports

• Documentation:

  • Use JSDoc comments for public functions, classes, and interfaces
  • Document complex logic with inline comments

Building

# Compile TypeScript
npm run build

# Run the server
npm start

Testing

# Run tests
npm test

Inspecting

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

# MCP sse inspect
npm start
npx @modelcontextprotocol/inspector

How to use

For Claude or Cursor config:

{
  "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
      }
    }
  }
}

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Support the Project

If you find this project helpful, consider buying me a coffee!

Scan the QR code above or click here to support the development of this project.

License

This project is licensed under the MIT License - see the LICENSE file for details.