Backstage MCP

🚀 Backstage MCP 后台

このプロジェクトは、Backstage と MCP を使用したサンプルで、Quarkus Backstage を通じて実装されています。サーバーは Goose を用いてテストされています。以下に詳細情報を示します。

✨ 主な機能

• 利用可能な Backstage テンプレートを一覧表示する
• コマンドラインからテンプレートをインスタンス化する

📦 インストール

先决条件

Backstage をインストールする必要があり、サービス間通信 が有効になっている必要があります。ユーザーはこのような通信に使用するトークンへのアクセス権を持っている必要があります。以下の yaml コードスニペットは、設定場所と方法を示しています：

app:
# ...
backend:
  # ... 
  auth:
    # ...
    externalAccess:
      - type: static
        options:
          token: <ここにトークンを入力>
          subject: curl-requests

📚 ドキュメント

構造

依存関係

このプロジェクトは以下の依存関係を使用しています：

        <dependency>
            <groupId>io.quarkiverse.mcp</groupId>
            <artifactId>quarkus-mcp-server-stdio</artifactId>
            <version>1.0.0.Alpha5</version>
        </dependency>

標準入力から読み取り、標準出力に書き込む mcp サーバーを実装しています。

また、以下の依存関係も使用しています：

        <dependency>
            <groupId>io.quarkiverse.backstage</groupId>
            <artifactId>quarkus-backstage</artifactId>
            <version>0.4.1</version>
        </dependency>

Backstage API との通信に使用されます。

実装

実装は非常にシンプルで、1 つのファイルのみ必要です： [[src/main/java/org/acme/Backstage.java]]

Gooseの設定

Goose は、対話型シェルとして動作し、プラグイン（mcp サーバーを含む）をサポートするローカル AI エージェントです。この mcp サーバーを使用するように Goose を設定するには、config.yaml に以下の拡張を追加してください：

  quarkus-backstage-mcp:
    args:
    - --quiet
    - /home/iocanel/demo/backstage-mcp/target/quarkus-app/quarkus-run.jar
    cmd: jbang
    enabled: true
    envs: {}
    name: quarkus-backstage-mcp
    type: stdio

サンプルコマンド

テンプレートの一覧表示

すべての利用可能な backstage テンプレートを一覧表示

テンプレートのインスタンス化

テンプレートをインスタンス化するには、テンプレートパラメータを含む values.yaml ファイルが必要です。Backstage CLI を使用してテンプレートのデフォルト値を抽出できます：

quarkus backstage template info --show-default-values <テンプレート名>

出力は values.yaml などのファイルに保存でき、Goose セッションで以下のコマンドを使用してインスタンス化できます：

<テンプレート名> から新しいプロジェクトを作成し、values.yaml の値を使用する