dcc-mcp/dcc-mcp-zbrush

Start the ZBrush MCP sidecar server (README 'Sidecar mode' command, dcc-mcp-zbrush --mode sidecar) over streamable HTTP on loopback and run MCP initialize plus tools/list (returned paginated tool list, nextCursor present).

cd <host-path> && git log -1 --format=%H 2>/dev/null; ls -la; cat README.md 2>/dev/null | head -300
cd <host-path> && ls -la .github/workflows 2>/dev/null; ls <host-path> 2>/dev/null; python3 --version; which uv pip pip3 node npm 2>/dev/null
cd <host-path> && grep -n "version\|name" pyproject.toml | head -20; sed -n 1,80p <host-path> | head -120; ls docs
cd /tmp && python3 -m venv /tmp/zbvenv && /tmp/zbvenv/bin/pip install -q "dcc-mcp-zbrush==0.2.30" 2>&1 | tail -20; echo rc=$?; ls /tmp/zbvenv/bin | grep -i zbrush; /tmp/zbvenv/bin/dcc-mcp-zbrush --help 2>&1 | head -40
(apt-get install -y -q python3.12-venv >/tmp/apt.log 2>&1 || (apt-get update -q >/dev/null 2>&1 && apt-get install -y -q python3.12-venv >>/tmp/apt.log 2>&1)); echo apt=$?; rm -rf /tmp/zbvenv && python3 -m venv /tmp/zbvenv && /tmp/zbvenv/bin/pip install -q "dcc-mcp-zbrush==0.2.30" 2>&1 | tail -20; echo rc=$?; ls /tmp/zbvenv/bin | grep -i zbrush; /tmp/zbvenv/bin/dcc-mcp-zbrush --help 2>&1 | head -60
whoami; tail -5 /tmp/apt.log; sudo -n true 2>&1 && echo sudo_ok
sudo apt-get update -q >/tmp/apt.log 2>&1; sudo apt-get install -y -q python3.12-venv >>/tmp/apt.log 2>&1; echo apt=$?; tail -3 /tmp/apt.log; rm -rf /tmp/zbvenv && python3 -m venv /tmp/zbvenv && /tmp/zbvenv/bin/pip install -q "dcc-mcp-zbrush==0.2.30" 2>&1 | tail -20; echo rc=$?; ls /tmp/zbvenv/bin | grep -i zbrush; /tmp/zbvenv/bin/dcc-mcp-zbrush --help 2>&1 | head -60
cd <host-path> && sed -n 1,80p docs/development.md
cd <host-path> && export NODE_USE_ENV_PROXY=1 && /tmp/zbvenv/bin/pip install -q -e . 2>&1 | tail -15; echo rc=$?; ls /tmp/zbvenv/bin | grep -i zbrush; /tmp/zbvenv/bin/dcc-mcp-zbrush --help 2>&1 | head -60
cd /tmp && (/tmp/zbvenv/bin/dcc-mcp-zbrush --mode sidecar --port 8765 --gateway-port 0 > /tmp/zb_sidecar.log 2>&1 &) ; sleep 8; cat /tmp/zb_sidecar.log | tail -20; curl -s -m 5 -X POST http://127.0.0.1:8765/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"smoke","version":"0"}}}'; echo; curl -s -m 5 -X POST http://127.0.0.1:8765/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' | head -c 1500
pkill -f "dcc-mcp-zbrush --mode sidecar --port 8765" ; sleep 2; pgrep -fa dcc-mcp-zbrush || echo no_server_left; mkdir -p <host-path> && cat > <host-path> <<'EOF'
{"kind":"mcp_http","argv":["/tmp/zbvenv/bin/dcc-mcp-zbrush","--mode","sidecar","--port","8765","--gateway-port","0","--socket-port","9876"],"cwd":"<host-path>"}
EOF
cat > <host-path> <<'EOF'
{"outcome":"working","operation":"Start the ZBrush MCP sidecar server (README 'Sidecar mode' command, dcc-mcp-zbrush --mode sidecar) over streamable HTTP on loopback and run MCP initialize plus tools/list (returned paginated tool list, nextCursor present).","operation_scope":"MCP server start and tools/list only. Not exercised: ZBrush host operations (tools/call against the live app) because ZBrush 2026.1+ is not available in the guest; the socket bridge on 127.0.0.1:9876 is not running, so the sidecar logs a warning and retries lazily.","steps":["python3 -m venv /tmp/zbvenv (after apt install python3.12-venv via sudo)","/tmp/zbvenv/bin/pip install -e . in <host-path> (pinned checkout pyproject version 0.2.30; PyPI only has up to 0.2.29)","/tmp/zbvenv/bin/dcc-mcp-zbrush --help","/tmp/zbvenv/bin/dcc-mcp-zbrush --mode sidecar --port 8765 --gateway-port 0 (MCP listening on http://127.0.0.1:8765/mcp)","POST initialize and tools/list to http://127.0.0.1:8765/mcp"],"deviations":["README 'Quick install > 1. Install a fixed wheel version' (python -m pip install dcc-mcp-zbrush==<version>): pinned version 0.2.30 is not on PyPI (max 0.2.29); used editable install from the pinned checkout instead.","Guest python3 venv lacked ensurepip: ran sudo apt-get install python3.12-venv (plain apt needed root lock)."],"stuck_step":null,"main_blocker":null,"suggested_fix":null}
EOF
cd /tmp && <env-var>=<host-path> python3 -I <host-path> --validate
pgrep -fa "dcc-mcp-zbrush" | grep -v pgrep || echo no_server_left; ls -la <host-path> 2>&1
mkdir -p <host-path> && cat > <host-path> <<'EOF'
{"kind":"mcp_http","argv":["/tmp/zbvenv/bin/dcc-mcp-zbrush","--mode","sidecar","--port","8765","--gateway-port","0","--socket-port","9876"],"cwd":"<host-path>"}
EOF
cat > <host-path> <<'EOF'
{"outcome":"working","operation":"Start the ZBrush MCP sidecar server (README 'Sidecar mode' command, dcc-mcp-zbrush --mode sidecar) over streamable HTTP on loopback and run MCP initialize plus tools/list (returned paginated tool list, nextCursor present).","operation_scope":"MCP server start and tools/list only. Not exercised: tools/call against a live ZBrush app, because ZBrush 2026.1+ is not available in the guest; the socket bridge on 127.0.0.1:9876 is not running, so the sidecar logs a warning and retries lazily.","steps":["sudo apt-get install python3.12-venv (plain apt needs root lock); python3 -m venv /tmp/zbvenv","/tmp/zbvenv/bin/pip install -e . in <host-path> (pinned checkout pyproject version 0.2.30)","/tmp/zbvenv/bin/dcc-mcp-zbrush --help","/tmp/zbvenv/bin/dcc-mcp-zbrush --mode sidecar --port 8765 --gateway-port 0 (MCP listening on http://127.0.0.1:8765/mcp)","POST initialize and tools/list to http://127.0.0.1:8765/mcp"],"deviations":["README 'Quick install > 1. Install a fixed wheel version' (python -m pip install dcc-mcp-zbrush==<version>): pinned version 0.2.30 is not on PyPI (max 0.2.29); used editable install from the pinned checkout instead.","Guest python3 venv lacked ensurepip: ran sudo apt-get install python3.12-venv."],"stuck_step":null,"main_blocker":null,"suggested_fix":null}
EOF
cd /tmp && <env-var>=<host-path> python3 -I <host-path> --validate; echo rc=$?