MCP

PawelWaj/MCP

3.3

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

The Backstage MCP Server acts as a comprehensive consultant for Backstage plugin development and customization within your development environment.

Tools
7
Resources
0
Prompts
0

Backstage MCP Server

The MCP server is essentially a complete Backstage consultant in your development environment! 🚀

A comprehensive Model Context Protocol (MCP) server providing extensive knowledge about Backstage for plugin development and customization.

Features

This MCP server provides access to:

  • Backstage Overview: Core concepts, features, benefits, and architecture
  • Plugin Development Guide: Complete guide for creating custom plugins
  • API Reference: REST endpoints, GraphQL APIs, and client libraries
  • Community Resources: Discord channels, common questions, and learning materials
  • Code Examples: Practical examples for common development scenarios
  • Plugin Scaffolding: Generate plugin templates with custom configurations

Available Tools

1. get_backstage_overview

Get comprehensive overview of Backstage framework.

  • Optional section parameter: whatIsBackstage, coreFeatures, benefits, architecture

2. get_plugin_development_guide

Get detailed plugin development guide.

  • Optional topic parameter: overview, gettingStarted, pluginStructure, commonPatterns, apis, testing, deployment, bestPractices

3. get_api_reference

Get Backstage API reference documentation.

  • Optional api parameter: catalogApi, scaffolderApi, techDocsApi, authApi, searchApi, proxyApi, graphqlApi

4. get_community_resources

Get community resources and support information.

  • Optional category parameter: officialChannels, communityPlugins, commonQuestions, learningResources, adoptionStories, contributing

5. get_backstage_examples

Get code examples and samples.

  • Optional type parameter: pluginExamples, catalogExamples, templateExamples, configExamples
  • Optional specific parameter for specific examples within a type

6. search_backstage_knowledge

Search across all knowledge bases.

  • Required query parameter: search terms

7. get_plugin_scaffold_template

Generate plugin scaffold templates.

  • Required pluginType: frontend, backend, fullstack, common
  • Required pluginName: name of your plugin
  • Optional features array: routing, api-client, entity-provider, scaffolder-action, search-collator

Installation

Option 1: Docker (Recommended for Sharing)

# Quick setup
./setup.sh

# Or manual setup
npm run docker:compose:up

Usage

With Cursor/Claude Desktop (Docker)

Add to your MCP configuration:

{
  "mcpServers": {
    "backstage": {
      "command": "docker",
      "args": ["exec", "-i", "backstage-mcp-server", "node", "dist/index.js"]
    }
  }
}

Sharing with Friends

See SHARING_GUIDE.md for complete instructions on sharing this server with friends.

Knowledge Base Coverage

  • Core Backstage Concepts: Software Catalog, Templates, TechDocs, Plugins
  • Plugin Development: Frontend, backend, and full-stack plugin creation
  • API Integration: REST APIs, GraphQL, client libraries
  • Community Insights: Discord discussions, common questions, best practices
  • Real Examples: Working code samples for typical scenarios
  • Configuration: App config, authentication, integrations

Contributing

This knowledge base is continuously updated with the latest Backstage information. To contribute:

  1. Update knowledge files in src/knowledge/
  2. Add new tools in src/index.ts
  3. Test with real Backstage scenarios
  4. Submit pull requests

Resources

License

Apache 2.0