backstage-mcp-server

tim-minter/backstage-mcp-server

3.2

If you are the rightful owner of backstage-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

A MCP (Model Context Protocol) server for interacting with Backstage software catalog.

Tools
4
Resources
0
Prompts
0

Backstage MCP Server

A MCP (Model Context Protocol) server that provides tools to interact with your instance of Backstage software catalog. This server allows you to list entities, get entity details, and view ancestry information from your Backstage instance.

Features

  • List Entities: Query Backstage entities with optional filtering by kind and namespace
  • Get Entity: Retrieve detailed information about a specific entity
  • Get Entity Ancestry: View the ancestry chain for any entity
  • Bearer Token Authentication: Secure authentication support for Backstage API

Installation

This MCP server is designed to run in a Docker container. You can use it through the Docker MCP Registry or run it locally.

Prerequisites

  • Docker Desktop
  • Python 3.11+ (for local development)

Running with Docker

docker build -t backstage-mcp .
docker run -e BACKSTAGE_BEARER_TOKEN=your_token_here -e BACKSTAGE_API_BASE=https://backstage.example.com/API/catalog backstage-mcp

Configuration

The server requires the following environment variables:

  • BACKSTAGE_API_BASE (optional): Base URL for your Backstage API catalog endpoint.
  • BACKSTAGE_BEARER_TOKEN (optional): Bearer token for Backstage API authentication

Tools

list_entities

List entities in Backstage, optionally filtered by kind and namespace.

Parameters:

  • kind (optional): Entity kind filter (e.g., 'Component', 'API', 'System')
  • namespace (optional): Namespace filter
  • limit (optional): Maximum number of entities to return (default: 10)

get_entity

Get a Backstage entity by kind, namespace, and name.

Parameters:

  • kind (required): Entity kind (e.g., 'Component', 'API', 'System')
  • namespace (required): Entity namespace
  • name (required): Entity name

get_entity_ancestry

Get ancestry information for a Backstage entity.

Parameters:

  • kind (required): Entity kind
  • namespace (required): Entity namespace
  • name (required): Entity name

set_bearer_token

Set the bearer token for Backstage API requests at runtime.

Parameters:

  • token (required): Bearer token for Backstage API authentication

Development

Local Setup

  1. Clone this repository:
git clone https://github.com/timinter/backstage-mcp-server.git
cd backstage-mcp-server
  1. Install dependencies:
pip install -r requirements.txt
  1. Run the server:
python backstage.py

Building the Docker Image

docker build -t backstage-mcp .

Contributing

This project is part of the Docker MCP Registry. To contribute:

  1. Fork the MCP Registry repository
  2. Follow the contributing guidelines
  3. Submit a pull request

License

Licensed under the Apache License, Version 2.0. See for details.

Related Links