Sovereign 8s.is mirror of standardgalactic/color_master
  • Python 99.1%
  • Dockerfile 0.9%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-03-15 20:58:04 +01:00
.idea hi 2026-03-13 10:31:26 +01:00
mcp_server Single create route, .env.example, test, README workflow, Docker healthcheck 2026-03-15 20:58:04 +01:00
output_dir hi 2026-03-13 10:31:26 +01:00
.dockerignore Add 3D visualization engine, MCP server, Docker, README 2026-03-13 10:53:10 +01:00
.env.example Single create route, .env.example, test, README workflow, Docker healthcheck 2026-03-15 20:58:04 +01:00
.gitignore Single create route, .env.example, test, README workflow, Docker healthcheck 2026-03-15 20:58:04 +01:00
Dockerfile Single create route, .env.example, test, README workflow, Docker healthcheck 2026-03-15 20:58:04 +01:00
main.py Single create route, .env.example, test, README workflow, Docker healthcheck 2026-03-15 20:58:04 +01:00
README.md Single create route, .env.example, test, README workflow, Docker healthcheck 2026-03-15 20:58:04 +01:00
requirements.txt Add 3D visualization engine, MCP server, Docker, README 2026-03-13 10:53:10 +01:00
test_mcp.py Single create route, .env.example, test, README workflow, Docker healthcheck 2026-03-15 20:58:04 +01:00

Color Master

3D time-series visualization with MCP server. Single create tool: dict[str, list] (SOA) → PNG/GIF outputs.

Workflow

data (dict[str, list]) → create() → output_dir/
  ├── per_key_static/
  ├── per_key_animation/
  └── combined/environment_3d.gif

Quick Start

pip install -r requirements.txt
python main.py

MCP Server

cp .env.example .env   # optional
python mcp_server/routes.py

Tool: create(data, amount_nodes=28, dims=360, output_dir="output_dir", quality_preset="default", use_demo_if_empty=True)

  • data: dict[str, list] – each key maps to a list of timestep items (lists, scalars, dicts, arrays)
  • If data is empty and use_demo_if_empty=True, runs hardcoded demo
  • Returns: {ok, out, static[], anim[], combined} or {ok: false, err}

Endpoints:

  • MCP: http://localhost:8000/mcp
  • Status: http://localhost:8000/status
  • Health: http://localhost:8000/health

Docker

docker build -t color-master-mcp .
docker run -p 8000:8000 color-master-mcp

Check status at startup: curl http://localhost:8000/status

Test

python test_mcp.py

Env

Var Default
MCP_HOST 0.0.0.0
MCP_PORT 8000
MCP_PATH /mcp