Sovereign 8s.is mirror of standardgalactic/color_master
- Python 99.1%
- Dockerfile 0.9%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
|
||
| .idea | ||
| mcp_server | ||
| output_dir | ||
| .dockerignore | ||
| .env.example | ||
| .gitignore | ||
| Dockerfile | ||
| main.py | ||
| README.md | ||
| requirements.txt | ||
| test_mcp.py | ||
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
datais empty anduse_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 |