Backstage MCP

🚀 Backstage MCP 後臺

這是一個藉助 Backstage 和 MCP 構建的示例項目，通過 Quarkus Backstage 得以實現。同時，服務器已使用 Goose 完成測試。下面為你詳細介紹該項目。

🚀 快速開始

此項目是使用 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 通信。

實現

實現非常簡單，只需要一個文件： [[src/main/java/org/acme/Backstage.java]]

配置 Goose

Goose 是一個本地 AI 代理，作為交互式 Shell 運行，並支持插件（包括 mcp 服務器）。要配置 Goose 使用此 mcp 服務器，請在 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 中的值