MCP Recommender

Instructions

Implementation Reference

• mcp_recommender/server.py:220-242 (handler)

  The handler function for the 'list_categories' MCP tool. It extracts unique categories from the recommender's MCP data, sorts them, counts MCPs per category, and returns a formatted Markdown list. Registered via @mcp.tool() decorator.

  @mcp.tool()
  def list_categories() -> str:
      """
      List all available MCP categories.
      
      Returns:
          Formatted list of available categories
      """
      try:
          categories = set(mcp['category'] for mcp in recommender.mcps)
          categories_list = sorted(categories)
          
          result = "### Available MCP Categories:\n\n"
          for i, category in enumerate(categories_list, 1):
              # Count MCPs in each category
              count = sum(1 for mcp in recommender.mcps if mcp['category'] == category)
              result += f"{i}. **{category}** ({count} MCPs)\n"
          
          result += f"\n**Total:** {len(recommender.mcps)} MCPs across {len(categories_list)} categories"
          return result
          
      except Exception as e:
          return f"### Error\nAn error occurred while listing categories: {str(e)}"