MCP Backstage Example

🚀 Using the Bee Agent Framework with the Backstage Model Context Protocol (MCP) Server

This repository demonstrates how to create a Model Context Protocol (MCP) server that provides tools for LLMs to communicate with a Backstage instance. It includes an example agent built using the Bee Agent Framework to show how to interact with the MCP server.

🚀 Quick Start

📦 Installation

Configure Backstage

Enable static, token-based access for easy Backstage access. This allows clients to interact using a token in the authorization header.

appConfig:
  backend:
    auth:
      externalAccess:
      - type: static
        options:
        token: 'notasecuretoken'
        subject: mcp

Run the MCP Server

Install dependencies and set environment variables:

cd server
npm i
cp .env.template .env

Edit the .env file with valid values, then start the server:

# Load variables
source .env

# Build and run the server
npm run build && npm start 

The MCP server will start listening at http://localhost:8080.

Run the Agent

In another terminal, install dependencies and set environment variables:

cd agent
cp .env.template .env
npm i

Run the agent:

npm run build && npm start