get_community_resources

Instructions

Implementation Reference

• src/index.ts:256-269 (handler)

  The handler function that executes the tool logic. It retrieves the community resources content for the given category (or all if unspecified) from the knowledge base and returns it as a formatted JSON text response in the MCP content format.

  private getCommunityResources(category?: string) {
    const content = category ? 
      this.knowledgeBase.community.content[category] : 
      this.knowledgeBase.community.content;
  
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(content, null, 2),
        },
      ],
    };
  }

• src/index.ts:95-104 (schema)

  The input schema defining the optional 'category' parameter with allowed enum values for filtering community resources.

  inputSchema: {
    type: 'object',
    properties: {
      category: {
        type: 'string',
        description: 'Specific category to retrieve (optional)',
        enum: ['officialChannels', 'communityPlugins', 'commonQuestions', 'learningResources', 'adoptionStories', 'contributing']
      }
    }
  }

• src/index.ts:93-105 (registration)

  Registration of the tool in the ListTools response, including name, description, and input schema.

    name: 'get_community_resources',
    description: 'Get community resources, support channels, and common questions about Backstage',
    inputSchema: {
      type: 'object',
      properties: {
        category: {
          type: 'string',
          description: 'Specific category to retrieve (optional)',
          enum: ['officialChannels', 'communityPlugins', 'commonQuestions', 'learningResources', 'adoptionStories', 'contributing']
        }
      }
    }
  },

• src/index.ts:183-184 (registration)

  Dispatch/registration in the CallToolRequest switch statement that routes to the handler method.

  case 'get_community_resources':
    return this.getCommunityResources(args?.category as string);

• src/knowledge/community-resources.ts:1-115 (helper)

  Supporting data file providing the structured community resources content used by the handler.

  export const communityResources = {
    title: "Backstage Community Resources",
    description: "Community resources, common questions, and support channels",
    content: {
      officialChannels: {
        discord: {
          url: "https://discord.gg/backstage-687207715902193673",
          description: "Main community Discord server for support and discussions",
          channels: [
            "#general - General discussions",
            "#help - Get help with Backstage",
            "#plugin-development - Plugin development discussions",
            "#showcase - Show off your Backstage implementations",
            "#contributors - For contributors and maintainers"
          ]
        },
        github: {
          main: "https://github.com/backstage/backstage",
          community: "https://github.com/backstage/community",
          communityPlugins: "https://github.com/backstage/community-plugins"
        },
        documentation: "https://backstage.io/docs",
        blog: "https://backstage.io/blog",
        newsletter: "https://info.backstage.spotify.com/newsletter"
      },
      communityPlugins: {
        registry: "https://github.com/backstage/community-plugins",
        popular: [
          "kubernetes - Kubernetes cluster integration",
          "jenkins - Jenkins CI/CD integration", 
          "sonarqube - Code quality metrics",
          "grafana - Monitoring dashboards",
          "jira - Issue tracking integration",
          "github-actions - GitHub Actions integration",
          "datadog - Monitoring and observability",
          "newrelic - Application performance monitoring"
        ]
      },
      commonQuestions: {
        gettingStarted: [
          "How do I create my first Backstage app?",
          "What are the system requirements for Backstage?",
          "How do I configure authentication?",
          "How do I add entities to the catalog?"
        ],
        pluginDevelopment: [
          "How do I create a custom plugin?",
          "How do I integrate with external APIs?",
          "How do I add custom entity types?",
          "How do I create scaffolder actions?",
          "How do I add custom pages to Backstage?"
        ],
        deployment: [
          "How do I deploy Backstage to production?",
          "What database should I use?",
          "How do I configure HTTPS?",
          "How do I set up monitoring?",
          "How do I backup my Backstage instance?"
        ],
        troubleshooting: [
          "Plugin not loading correctly",
          "Authentication issues",
          "Database connection problems",
          "Build and deployment errors",
          "Performance optimization"
        ]
      },
      learningResources: {
        tutorials: [
          "Getting Started with Backstage",
          "Building Your First Plugin",
          "Integrating External Services",
          "Customizing the Software Catalog",
          "Setting up TechDocs"
        ],
        videos: [
          "KubeCon presentations on Backstage",
          "Spotify engineering blog videos",
          "Community meetup recordings"
        ],
        workshops: [
          "Backstage Community Sessions (monthly)",
          "Plugin development workshops",
          "Deployment and operations training"
        ]
      },
      adoptionStories: {
        companies: [
          "Spotify - Original creator and heavy user",
          "Netflix - Large-scale deployment",
          "Expedia - Multi-team adoption",
          "American Airlines - Enterprise implementation",
          "IKEA - Retail industry use case"
        ],
        useCases: [
          "Developer portal consolidation",
          "Service catalog management", 
          "Documentation centralization",
          "Scaffolding standardization",
          "Infrastructure visibility"
        ]
      },
      contributing: {
        ways: [
          "Code contributions to core",
          "Plugin development",
          "Documentation improvements",
          "Bug reports and feature requests",
          "Community support"
        ],
        governance: "CNCF governance model with technical steering committee",
        codeOfConduct: "Contributor Covenant Code of Conduct"
      }
    }
  };