ACMS

Downloads PyPI Version Python version

ACMS is a Model Context Protocol (MCP) server that provides programmatic access to Apple's container CLI tool on macOS. ACMS can be run locally or accessed remotely via HTTP/S.

The point of ACMS is to bring attention to the Containerization package and Container cli efforts. Inspiration for ACMS came from coderunner.

Prerequisites

• Mac with Apple Silicon
• macOS 26+ - It can run on Sequoia with limitations.
• Xcode 26 - required to compile containerization
• Apple Containerization Framework - (required for container functionality)
• Apple Container Cli - installed and in PATH

Quick Start

Install

Either clone the repository or pip install acms in a venv.

Start Apple Container Services

container system start

Start ACMS Server

# Recommended: Use the startup script
./start-acms.sh

# Or start directly with custom options
python3 acms/acms.py --port 8765 --host 127.0.0.1 > acms.log 2>&1 &

Configure MCP Client

Add to your MCP client configuration:

claude mcp add --transport http acms http://localhost:8765/mcp

Usage Examples

"acms create an ubuntu x64 container ..."

Testing

ACMS includes comprehensive end-to-end testing, just tell Claude to run the "ACMS CLAUDE TEST GUIDE".

Security Considerations

This is not secure, especially if you run it on a remote Mac OS endpoint on your home net. Also, you can lose your data when Claude tries to be helpful.

mcp-name: io.github.gattjoe/ACMS