Backstage MCP Server
Provides comprehensive Backstage framework knowledge and development assistance through an MCP server. Enables plugin development, API reference access, code scaffolding, and community resource discovery for Backstage customization.
README
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
sectionparameter:whatIsBackstage,coreFeatures,benefits,architecture
2. get_plugin_development_guide
Get detailed plugin development guide.
- Optional
topicparameter:overview,gettingStarted,pluginStructure,commonPatterns,apis,testing,deployment,bestPractices
3. get_api_reference
Get Backstage API reference documentation.
- Optional
apiparameter:catalogApi,scaffolderApi,techDocsApi,authApi,searchApi,proxyApi,graphqlApi
4. get_community_resources
Get community resources and support information.
- Optional
categoryparameter:officialChannels,communityPlugins,commonQuestions,learningResources,adoptionStories,contributing
5. get_backstage_examples
Get code examples and samples.
- Optional
typeparameter:pluginExamples,catalogExamples,templateExamples,configExamples - Optional
specificparameter for specific examples within a type
6. search_backstage_knowledge
Search across all knowledge bases.
- Required
queryparameter: search terms
7. get_plugin_scaffold_template
Generate plugin scaffold templates.
- Required
pluginType:frontend,backend,fullstack,common - Required
pluginName: name of your plugin - Optional
featuresarray: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:
- Update knowledge files in
src/knowledge/ - Add new tools in
src/index.ts - Test with real Backstage scenarios
- Submit pull requests
Resources
License
Apache 2.0
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.