Unleash MCP Server

Unleash MCP サーバー

Unleash Feature Toggle システムと連携する Model Context Protocol（MCP）サーバーの実装です。

概要

このプロジェクトは、Model Context Protocol（MCP）を使用して、LLM アプリケーションと Unleash のフィーチャーフラグシステムをつなぐブリッジを提供します。AI アプリケーションで次のことが可能になります。

1. Unleash のフィーチャーフラグのステータスを確認する
2. LLM にフィーチャーフラグの情報を公開する
3. フィーチャーフラグを作成する
4. フィーチャーフラグを更新する
5. すべてのプロジェクトを一覧表示する

目次

• 要件
• インストール
• アーキテクチャ
• 設定
• 開発
• コントリビューション
• ライセンス

要件

• 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）
  • 関数／メソッド：camelCase を使用します（例：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
      }
    }
  }
}

コントリビューション

コントリビューションを歓迎します！お気軽にプルリクエストを送信してください。

プロジェクトを応援する

このプロジェクトがお役に立ちましたら、コーヒーをごちそうしていただけるとうれしいです！

上の QR コードをスキャンするか、こちらをクリックして、このプロジェクトの開発をご支援ください。

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細については LICENSE ファイルをご覧ください。