{
  "markdown": "# ACMS (Apple Container MCP Server)\n\n[![Downloads](https://pepy.tech/badge/acms/month)](https://pepy.tech/project/acms)\n[![PyPI Version](https://img.shields.io/pypi/v/acms.svg)](https://pypi.org/project/acms/)\n[![Python version](https://img.shields.io/pypi/pyversions/acms.svg)](https://pypi.org/project/acms/)\n\n**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.\n\nThe point of ACMS is to bring attention to the [Containerization](https://github.com/apple/containerization) package and [Container cli](https://github.com/apple/container) efforts. Inspiration for ACMS came from [coderunner](https://github.com/instavm/coderunner).\n\n## Prerequisites\n\n- **Mac with Apple Silicon**\n- **macOS 26+** - It can run on Sequoia with [limitations](https://github.com/apple/container/blob/main/docs/technical-overview.md#macos-15-limitations).\n- **Xcode 26** - required to compile containerization\n- **Apple Containerization Framework** - (required for container functionality)\n- **Apple Container Cli** - installed and in PATH\n\n## Quick Start\n\n### Install\n\nEither clone the repository or `pip install acms` in a venv.\n\n### Start Apple Container Services\n```bash\n\ncontainer system start\n\n```\n\n### Start ACMS Server\n```bash\n# Recommended: Use the startup script\n./start-acms.sh\n\n# Or start directly with custom options\npython3 acms/acms.py --port 8765 --host 127.0.0.1 > acms.log 2>&1 &\n```\n\n### Configure MCP Client\nAdd to your MCP client configuration:\n\n```\nclaude mcp add --transport http acms http://localhost:8765/mcp\n```\n\n## Usage Examples\n\n\"acms create an ubuntu x64 container ...\"\n\n## Testing\n\nACMS includes comprehensive end-to-end testing, just tell Claude to run the \"ACMS CLAUDE TEST GUIDE\".\n\n## Security Considerations\n\nThis 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.\n\n![footgun](./images/footgun.png)\n\nmcp-name: io.github.gattjoe/ACMS\n",
  "bytes": 2071,
  "sha": "cbf93b64aadceaf44d3d0590aaeb05d46b22fa968e0b7546fb6060856aac6b9f",
  "repo_slug": "gattjoe/acms",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_gattjoe_acms_f373b4d5/readme"
}