Constellation

You can transform astronomical constellation patterns into actionable composition parameters for AI image generation. This MCP server translates 22 major constellations, including their geometric and mythological context, into deterministic, output-ready values suitable for artwork generation and thematic guidance.

How to use

Use this MCP server with your MCP client to request constellation-based compositions for images. You can search constellations by theme, shape, or brightness, and then generate a composition specifically mapped to a chosen constellation. The server offers multiple output formats and scales canvases to your needs.

Key capabilities include 1) searching constellations to find an appropriate pattern, 2) generating a composition that maps a constellation to parameters used by your image generator, and 3) listing all available constellations for quick browsing.

Practical workflow tips:

• Search for a constellation by a thematic keyword (for example, “hunting” or “mythology”).
• Pick a constellation from the results and request a composition with your desired canvas size.
• Use the resulting composition parameters to drive your image generation pipeline, with deterministic behavior tied to the star-pattern input.

How to install

Prerequisites
- Python 3.8 or newer
- Access to a Python environment with pip available
- Optional: a client or environment capable of sending MCP requests to your local or remote MCP server

Install the MCP server package with development dependencies using Python’s package manager:

pip install -e ".[dev]"

Start the MCP server using the provided command (as shown in the usage example):
```constellation-composition-mcp```

Configure your MCP client to connect to this server by adding the MCP server entry to your client configuration under mcpServers. Use the following snippet as a starting point:

{
  "mcpServers": {
    "constellation": {
      "command": "constellation-composition-mCP"
    }
  }
}

Note: Use the exact command name shown when starting the server in your environment. If your client requires explicit JSON structure, adapt the keys to your client’s conventions while keeping the command intact.

## Additional notes

This MCP server provides deterministic mappings from constellation patterns to composition parameters, enabling consistent results across renders. It supports programmatic usage through a Python interface for searching constellations and generating compositions, in addition to direct command-line usage.

If you need a quick programmatic example, you can leverage the available functions to search for constellations and generate compositions by name, then pass the resulting parameters to your image generation workflow.

## Available tools

### search\_constellations

Search constellations by theme, shape, or brightness to find suitable patterns for composition.

### generate\_constellation\_composition

Generate a composition by constellation name with specified canvas dimensions, producing parameters for image generation.

### list\_all\_constellations

Browse all available constellations supported by the server.