Constellation Composition MCP Server

Instructions

Implementation Reference

• src/constellation_composition_mcp/server.py:1471-1518 (handler)

  Implementation of the 'list_all_constellations' MCP tool which lists all available constellations with their basic metadata.

  @mcp.tool(
      name="list_all_constellations",
      annotations={
          "title": "List All Available Constellations",
          "readOnlyHint": True,
          "destructiveHint": False,
          "idempotentHint": True,
          "openWorldHint": False
      }
  )
  async def list_all_constellations(response_format: ResponseFormat = ResponseFormat.MARKDOWN) -> str:
      """
      List all available constellations with basic information.
      
      Provides a quick overview of all 22 major constellations available in the system,
      including their abbreviations and primary themes. Useful for browsing options
      or understanding the full scope of available compositional patterns.
      
      Args:
          response_format: Output format ('markdown' or 'json')
      
      Returns:
          str: Complete list of constellations with basic metadata
      """
      
      constellation_list = []
      for name, data in sorted(CONSTELLATIONS.items()):
          constellation_list.append({
              'name': name,
              'abbreviation': data.get('abbr'),
              'theme': data.get('theme'),
              'shape': data.get('shape')
          })
      
      if response_format == ResponseFormat.JSON:
          return json.dumps({
              'constellations': constellation_list,
              'total_count': len(constellation_list)
          }, indent=2)
      else:
          md = f"# Available Constellations ({len(constellation_list)})\n\n"
          for item in constellation_list:
              md += f"## {item['name']} ({item['abbreviation']})\n\n"
              md += f"**Theme:** {item['theme']}\n\n"
              md += f"**Shape Pattern:** {item['shape'].replace('_', ' ').title()}\n\n"
              md += "---\n\n"
          return md