Backstage MCP

Backstage MCP

Backstage と MCP を Quarkus Backstage 経由で使用する例です。 このサーバーは Goose でテスト済みです。詳細は以下をご覧ください。

特長

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

要件

Backstage のインストールが必要です。 インストールでは、Service to Service 通信を有効にする必要があります。 ユーザーは、その通信に使用するトークンにアクセスできる必要があります。以下の yaml スニペットで、設定場所と設定方法を示します。

app:
# ...
backend:
  # ... 
  auth:
    # ...
    externalAccess:
      - type: static
        options:
          token: <put your token here>
          subject: curl-requests

構成

依存関係

このプロジェクトでは、以下を使用します。

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

stdin から読み取り、stdout に書き込む 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

プロンプトの例

テンプレートの一覧表示

list all the available backstage templates

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

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

quarkus backstage template info --show-default-values <template name>

出力を values.yaml などのファイルに保存してから、goose のセッションでテンプレートをインスタンス化するために使用できます。

create a new project from template <template name> using values from values.yaml