Constellation Composition MCP Server

Instructions

Implementation Reference

• src/constellation_composition_mcp/server.py:1519-1591 (handler)

  The handler function `get_server_info` provides comprehensive server metadata, capabilities, and status regarding available constellations, rhythmic presets, and visual types.

  # ============================================================================
  # PHASE 2.6 / 2.7 MCP TOOLS
  # ============================================================================
  
  @mcp.tool(
      name="get_server_info",
      annotations={
          "title": "Get Server Info and Capabilities",
          "readOnlyHint": True,
          "destructiveHint": False,
          "idempotentHint": True,
          "openWorldHint": False
      }
  )
  async def get_server_info() -> str:
      """
      Get server metadata, capabilities, and Phase 2.6/2.7 status.
  
      Layer 1: Pure reference (0 tokens).
  
      Returns comprehensive information about the constellation composition
      server including available tools, parameter space dimensions, canonical
      states, rhythmic presets, and visual vocabulary types.
      """
      info = {
          "server": "constellation_composition_mcp",
          "description": "Maps astronomical constellation patterns to compositional "
                         "parameters, rhythmic dynamics, and image generation prompts",
          "version": "2.7.0",
          "constellations_available": len(CONSTELLATIONS),
          "parameter_space": {
              "dimensions": len(CONSTELLATION_PARAMETER_NAMES),
              "parameters": CONSTELLATION_PARAMETER_NAMES,
              "bounds": [0.0, 1.0],
              "canonical_states": len(CONSTELLATION_CANONICAL_STATES)
          },
          "phase_1a_trajectory": {
              "enabled": True,
              "method": "cosine_interpolation",
              "tools": ["compute_constellation_trajectory"]
          },
          "phase_2_6_rhythmic": {
              "enabled": True,
              "presets": {
                  name: {
                      "period": cfg["steps_per_cycle"],
                      "pattern": cfg["pattern"],
                      "states": f"{cfg['state_a']} ↔ {cfg['state_b']}"
                  }
                  for name, cfg in CONSTELLATION_RHYTHMIC_PRESETS.items()
              },
              "all_periods": sorted(set(
                  p["steps_per_cycle"] for p in CONSTELLATION_RHYTHMIC_PRESETS.values()
              )),
              "tools": ["list_constellation_presets", "apply_constellation_preset"]
          },
          "phase_2_7_visualization": {
              "enabled": True,
              "visual_types": list(CONSTELLATION_VISUAL_TYPES.keys()),
              "visual_type_count": len(CONSTELLATION_VISUAL_TYPES),
              "prompt_modes": ["composite", "split_keywords", "descriptive"],
              "tools": ["generate_constellation_attractor_prompt"]
          },
          "tier_4d_composition": {
              "compatible": True,
              "domain_id": "constellation",
              "tools": ["get_constellation_coordinates",
                        "get_constellation_domain_registry_config"]
          }
      }
      return json.dumps(info, indent=2)