Unleash Feature Flag MCP Server

Unleash Feature Flag MCP サーバー

このリポジトリには、Unleash のフィーチャーフラグ管理システムとやり取りするための Model Context Protocol（MCP）サーバーが含まれています。AI エージェントは、Unleash API を通じてフィーチャーフラグを管理できます。

MCP とは？

Model Context Protocol（MCP）は、AI モデルが外部のツールやデータソースとやり取りできるようにするための仕様です。このサーバーは Unleash 向けの MCP プロトコルを実装しており、AI アシスタントがプログラムからフィーチャーフラグを管理できます。

インストール

npm からパッケージをインストールできます。

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

または、npx を使って直接実行できます。

npx @ylin6/unleash-ff-mcp-server

設定

サーバーには次の環境変数が必要です。

• UNLEASH_API_URL：Unleash API インスタンスの URL
• UNLEASH_AUTH_TOKEN：Unleash インスタンスの認証トークン

利用可能なツール

MCP サーバーは、フィーチャーフラグを管理するための次のツールを提供します。

プロジェクトの取得

Unleash インスタンス内のすべてのプロジェクトの一覧を取得します。

フィーチャーの取得

特定のプロジェクト内のすべてのフィーチャーフラグを取得します。

パラメーター：

• projectId：プロジェクトの ID

フィーチャーフラグの作成

プロジェクト内に新しいフィーチャーフラグを作成します。

パラメーター：

• projectId：プロジェクトの ID
• name：フィーチャーフラグの名前
• description：フィーチャーフラグの説明
• type：フィーチャーフラグの種類（例：「release」、「experiment」、「operational」、「kill-switch」）

フィーチャーフラグの更新

既存のフィーチャーフラグを更新します。

パラメーター：

• projectId：プロジェクトの ID
• featureId：フィーチャーフラグの ID
• description：フィーチャーフラグの新しい説明
• type：フィーチャーフラグの新しい種類

フィーチャーフラグの取得

特定のフィーチャーフラグの詳細を取得します。

パラメーター：

• projectId：プロジェクトの ID
• featureId：フィーチャーフラグの ID

Cursor での使用

この MCP サーバーを Cursor で使用するには、Cursor の設定で次のコマンドを使用します。

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

例

Cursor／Claude との会話例：

You: Show me all the feature flags in the 'dashboard' project

Claude: I'll fetch all the 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: operational)
...

開発

MCP サーバーの動作を調べるには、次のコマンドを実行します。

npm run inspect

これにより MCP inspector を使用して、リクエストとレスポンスのパターンを分析できます。

ライセンス

ISC