Constellation Composition MCP Server

Instructions

Implementation Reference

• src/constellation_composition_mcp/server.py:1768-1803 (handler)

  The implementation of the 'apply_constellation_preset' tool, which takes a rhythmic preset name as input and generates a complete oscillation trajectory of 5D coordinates over one full cycle.

      name="apply_constellation_preset",
      annotations={
          "title": "Apply Rhythmic Preset — Generate Oscillation Sequence",
          "readOnlyHint": True,
          "destructiveHint": False,
          "idempotentHint": True,
          "openWorldHint": False
      }
  )
  async def apply_constellation_preset(params: RhythmicPresetInput) -> str:
      """
      Apply a Phase 2.6 rhythmic preset, generating a complete oscillation
      sequence over one full period.
  
      Layer 2: Deterministic sequence generation (0 tokens).
  
      Returns a trajectory of 5D coordinate states tracing one complete cycle
      of the preset oscillation. This output is directly usable by:
      - Tier 4D integrate_forced_limit_cycle for single-domain orbits
      - Tier 4D integrate_forced_limit_cycle_multi_domain for composition
      - Phase 2.7 generate_constellation_attractor_prompt for keyframe prompts
      """
      cfg = CONSTELLATION_RHYTHMIC_PRESETS[params.preset_name]
      trajectory = _generate_preset_trajectory(cfg)
  
      return json.dumps({
          "preset_name": params.preset_name,
          "period": cfg["steps_per_cycle"],
          "pattern": cfg["pattern"],
          "state_a": cfg["state_a"],
          "state_b": cfg["state_b"],
          "description": cfg["description"],
          "parameter_names": CONSTELLATION_PARAMETER_NAMES,
          "trajectory": trajectory,
          "trajectory_length": len(trajectory)
      }, indent=2)