Constellation Composition MCP Server

Search for constellations by name, theme, visual characteristics, or shape.

Useful for discovering which constellations match specific compositional needs or thematic requirements. Returns constellation details including mythology, visual characteristics, and shape patterns.

Args: params (ConstellationSearchInput): Search parameters including: - query: Text search for name/theme/characteristic - shape_type: Filter by geometric shape - brightness: Filter by brightness pattern - response_format: Output format (markdown or json)

Returns: str: List of matching constellations with their characteristics

Generate detailed composition parameters mapped from a constellation's geometry and mythology.

Translates astronomical star patterns into practical compositional guidance for image generation, including focal point placement, visual flow, balance characteristics, and thematic elements derived from constellation mythology.

This uses a deterministic zero-LLM-cost approach for geometric translation, making it highly efficient for batch processing and consistent results.

Args: params (ConstellationCompositionInput): Configuration including: - constellation_name: Name or abbreviation of constellation - canvas_width: Target canvas width in pixels (512-4096) - canvas_height: Target canvas height in pixels (512-4096) - include_mythology: Include mythological themes (boolean) - response_format: Output format (json or markdown)

Returns: str: Structured composition parameters in requested format, including: - focal_points: List of primary visual anchors with positions and weights - visual_flow: Directional movement and rhythm patterns - balance: Visual balance type and center of mass - spatial_distribution: How elements spread across frame - mythology_themes: Key thematic elements from constellation story - suggested_elements: Concrete suggestions for subjects, lighting, atmosphere, colors

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

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.

Extract normalized 5D parameter coordinates for a canonical state or constellation name.

Layer 1: Pure taxonomy lookup (0 tokens).

If a canonical state name is given (e.g. 'orion_grandeur'), returns its exact coordinates. If a constellation name is given (e.g. 'Orion'), returns the nearest canonical state's coordinates with distance metric.

Coordinates are suitable for:

• Trajectory computation (Phase 1A)

• Rhythmic composition input (Phase 2.6)

• Attractor visualization (Phase 2.7)

• Multi-domain composition (Tier 4D)

List all available Phase 2.6 rhythmic presets with their parameters.

Layer 1: Pure taxonomy lookup (0 tokens).

Returns preset names, periods, oscillation patterns, state pairs, and descriptions. Presets define temporal oscillation patterns between canonical constellation states for rhythmic composition and Tier 4D multi-domain limit cycle discovery.

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

Compute smooth interpolation trajectory between two canonical states.

Layer 2: Deterministic interpolation (0 tokens).

Uses cosine ease-in-out for perceptually smooth transitions. Each step includes full 5D coordinates suitable for attractor prompt generation or multi-domain composition input.

Generate image-generation-ready prompts from 5D constellation coordinates.

Layer 2: Deterministic vocabulary extraction (0 tokens).

Translates abstract parameter coordinates into concrete visual vocabulary suitable for Stable Diffusion, ComfyUI, DALL-E, or Midjourney. Three output modes are available:

• composite: Single prompt string combining keywords and geometric specs. Best for direct image generation.

• split_keywords: Categorized keyword lists (visual type, specifications, parameter descriptors). Best for ComfyUI prompt engineering.

• descriptive: Narrative paragraph prompt. Best for DALL-E / Midjourney.

Coordinates can be provided directly, or derived from a canonical state name.

List all constellation visual types with their coordinates and keywords.

Layer 1: Pure taxonomy lookup (0 tokens).

Returns the complete visual vocabulary catalog used by the attractor prompt generator. Each visual type represents a region of the 5D constellation parameter space with associated image-generation keywords.

Return Tier 4D integration configuration for compositional limit cycles.

Layer 2: Pure lookup (0 tokens).

Returns the domain signature for registering with aesthetic-dynamics-core multi-domain composition. Includes domain_id, parameter names, preset periods, and canonical state coordinates — everything needed for integrate_forced_limit_cycle_multi_domain.