makehuman-mcp

# makehuman-core (`mhcore`) A **GUI-free** (no Qt, no OpenGL) Python library for building [MakeHuman](http://www.makehumancommunity.org/) characters programmatically: set body properties, apply modifiers, equip clothes/hair/eyes/skin, and save/export — from a script, a server, or CI, with no running MakeHuman app. It works by vendoring the unmodified MakeHuman source (`_vendor/`) and driving it through a small headless shim (`mhcore/`) that stubs the GUI/GL modules and supplies a headless application object. The character/geometry pipeline in MakeHuman is pure numpy, so nothing here needs a display or a GPU. ## Use with a coding agent Needs [uv](https://docs.astral.sh/uv/). First launch downloads ~430 MB of character data to `~/.cache/mhcore` (one time). OpenCode / Cursor (`opencode.json`): ```json { "mcp": { "makehuman": { "type": "local", "command": ["uvx", "makehuman-mcp"] } } } ``` Claude Desktop / Claude Code (`claude_desktop_config.json` / `.mcp.json`): ```json { "mcpServers": { "makehuman": { "command": "uvx", "args": ["makehuman-mcp"] } } } ``` Until the package is on PyPI, point uvx at this repo: ```json "command": ["uvx", "--from", "git+https://github.com/vidya-hub/makehuman-core", "makehuman-mcp"] ``` ## Library install A git clone already contains the data. Editable install: ```bash git clone https://github.com/vidya-hub/makehuman-core.git cd makehuman-core python3 -m venv .venv ./.venv/bin/pip install -e . ``` Or `uvx makehuman-mcp` / `pip install makehuman-mcp` — data is fetched on first `import mhcore` if `data/` is not next to the package. Override with `MHCORE_DATA=/path/to/data`. ## Usage ```python import mhcore h = mhcore.new_human() # body macros (0.0 - 1.0) h.set_gender(1.0).set_age(0.5).set_weight(0.6).set_muscle(0.8).set_height(0.7) # fine detail modifiers print(len(h.list_modifiers())) # ~269 available h.apply_modifier("head/head-oval", 0.4) # assets (discover, then…