macOS: Container runtime not available for Toolhive

[JAORMX]

Problem Description

Toolhive fails to run MCP servers on macOS GitHub Actions runners due to lack of container runtime support.

Current Behavior

1. Toolhive CLI installs successfully on macOS
2. When attempting to run an MCP server, Toolhive reports: Error: failed to create workload manager: no supported container runtime available: container runtime not found
3. This occurs even though we detect macOS and set CONTAINER_RUNTIME=auto

Expected Behavior

Toolhive should be able to run MCP servers on macOS runners, either by:

• Using its built-in container runtime management
• Working without containers on macOS
• Providing clear guidance on macOS requirements

Technical Details

• GitHub Actions macOS runners don't have Docker or Podman installed by default
• Docker Desktop would require additional setup and licensing considerations
• The error suggests Toolhive still requires a container runtime even when set to "auto"

Test Logs

Running on macOS - Toolhive will manage containers internally
CONTAINER_RUNTIME=auto
...
Error: failed to create workload manager: no supported container runtime available: container runtime not found

Potential Solutions

1. Investigate if Toolhive can run without containers on macOS
2. Add Docker Desktop installation step for macOS (with licensing considerations)
3. Use Colima or other Docker alternatives
4. Document macOS limitations and recommend Linux runners
5. Work with Toolhive team to improve macOS support

Workarounds

Currently, users should:

• Use Linux runners for running MCP servers
• Use macOS only for installation testing

Related

• CI Run: https://github.com/StacklokLabs/toolhive-actions/actions/runs/16902922581
• Toolhive may need updates to support containerless operation on macOS