Unleash Ff MCP Server

🚀 Unleash Feature Flag MCP Server

This repository contains a Model Context Protocol (MCP) server for interacting with the Unleash feature management system. It allows AI agents to manage feature flags via the Unleash API.

🚀 Quick Start

This MCP server enables AI agents to interact with the Unleash feature management system. It implements the Unleash version of the MCP protocol, allowing AI assistants to programmatically manage feature flags.

✨ Features

• MCP Compatibility: Implements the Model Context Protocol (MCP) for Unleash, enabling seamless interaction between AI models and the Unleash feature management system.
• Feature Flag Management: Provides a set of tools to manage feature flags in Unleash, including retrieving projects and features, creating, updating, and getting detailed information about feature flags.
• Integration with Cursor: Can be easily integrated with Cursor, allowing users to manage feature flags within the Cursor environment.

📦 Installation

You can install the package from npm:

npm install -g @ylin6/unleash-ff-mcp-server

Or run it directly using npx:

npx @ylin6/unleash-ff-mcp-server

📚 Documentation

Configuration

The server requires the following environment variables:

• UNLEASH_API_URL: The URL of your Unleash API instance.
• UNLEASH_AUTH_TOKEN: The authentication token for your Unleash instance.

Available Tools

The MCP server provides various tools for managing feature flags:

Get Projects

Retrieve all projects in your Unleash instance.

Get Features

Retrieve all feature flags in a specific project.

Parameters:

• projectId: The ID of the project.

Create Feature Flag

Create a new feature flag in a project.

Parameters:

• projectId: The ID of the project.
• name: The name of the feature.
• description: The description of the feature.
• type: The type of the feature (e.g., "release", "experiment", "ops", "kill").

Update Feature Flag

Update an existing feature flag.

Parameters:

• projectId: The ID of the project.
• featureId: The ID of the feature.
• description: The new description.
• type: The new type.

Get Feature Flag

Retrieve detailed information about a specific feature flag.

Parameters:

• projectId: The ID of the project.
• featureId: The ID of the feature.

Usage with Cursor

To use this MCP server in Cursor, use the following command in your Cursor settings:

env UNLEASH_API_URL=XXXX UNLEASH_AUTH_TOKEN=XXX npx -y @ylin6/unleash-ff-mcp-server

Example

Example conversation with Cursor/Claude:

You: Let me see all feature flags in the 'dashboard' project.

Claude: I'll get all feature flags in the 'dashboard' project for you.
[Claude uses the getFeatures tool with projectId='dashboard']

Claude: Here are all the feature flags in the 'website' project:
- new-homepage (Type: release)
- dark-mode (Type: experiment)
- beta-footer (Type: ops)
...

Development

To check the operation of the MCP server, you can run:

npm run inspect

This will use the MCP inspector to analyze the request/response patterns.

📄 License

ISC