🚀 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 中的值