# ACMS (Apple Container MCP Server)
**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](https://github.com/apple/containerization) package and [cli](https://github.com/apple/container) efforts. Inspiration for ACMS came from [coderunner](https://github.com/instavm/coderunner).
## Features (as pitched by Claude)
- **50+ Container Operations** across 9 functional categories
- **HTTP/WebSocket Transport** via FastMCP for modern connectivity
- **Robust Parameter Validation** supporting JSON strings and native arrays
- **Production-Ready** with 100% tested functionality
## Prerequisites
- **Mac with Apple Silicon**
- **macOS 26+** - It can run on Sequoia with [limitations](https://github.com/apple/container/blob/main/docs/technical-overview.md#macos-15-limitations).
- **Xcode 26** - required to compile containerization
- **Apple Containerization Framework** - (required for container functionality)
- **Apple Container Cli** - installed and in PATH
- **Python 3.8+** - with asyncio support
## Quick Start
### Install
Either clone the repository or `pip install acms` in a venv.
### Start Apple Container Services
```bash
# Required for most operations
container system start
# Verify system status
container system status
```
### Start ACMS Server
```bash
# 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.
mcp-name: io.github.gattjoe/ACMS
Raw data
{
"_id": null,
"home_page": null,
"name": "ACMS",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "AI, Apple, MCP, container",
"author": null,
"author_email": "Joe Gatt <gattjoe@users.noreply.github.com>",
"download_url": "https://files.pythonhosted.org/packages/5c/55/3df154c23be0294ed1cc9e20439a5786e4a20a94209c5be59cdead3d9761/acms-0.0.4.tar.gz",
"platform": null,
"description": "# ACMS (Apple Container MCP Server)\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 [cli](https://github.com/apple/container) efforts. Inspiration for ACMS came from [coderunner](https://github.com/instavm/coderunner).\n\n## Features (as pitched by Claude)\n\n- **50+ Container Operations** across 9 functional categories\n- **HTTP/WebSocket Transport** via FastMCP for modern connectivity\n- **Robust Parameter Validation** supporting JSON strings and native arrays\n- **Production-Ready** with 100% tested functionality\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- **Python 3.8+** - with asyncio support\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# Required for most operations\ncontainer system start\n\n# Verify system status\ncontainer system status\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.\n\nmcp-name: io.github.gattjoe/ACMS\n",
"bugtrack_url": null,
"license": null,
"summary": "ACMS is a Model Context Protocol (MCP) server that provides programmatic access to Apple's container CLI tool on macOS.",
"version": "0.0.4",
"project_urls": {
"changelog": "https://github.com/gattjoe/ACMS/blob/master/CHANGELOG.md",
"documentation": "https://github.com/gattjoe/ACMS/blob/master/README.md",
"homepage": "https://github.com/gattjoe/ACMS",
"repository": "https://github.com/gattjoe/ACMS"
},
"split_keywords": [
"ai",
" apple",
" mcp",
" container"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "154acc5002e64437ea153e49ca2b92aa88506e1622277bc02289e8c48ce11438",
"md5": "646c5eec5787f1fd17b9f8e4f6b9bdc3",
"sha256": "16cd1fdf37e43c57cef4baaec834792b1d541d4a455abbd5704f399c84256cf8"
},
"downloads": -1,
"filename": "acms-0.0.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "646c5eec5787f1fd17b9f8e4f6b9bdc3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 18755,
"upload_time": "2025-10-28T00:36:58",
"upload_time_iso_8601": "2025-10-28T00:36:58.477141Z",
"url": "https://files.pythonhosted.org/packages/15/4a/cc5002e64437ea153e49ca2b92aa88506e1622277bc02289e8c48ce11438/acms-0.0.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "5c553df154c23be0294ed1cc9e20439a5786e4a20a94209c5be59cdead3d9761",
"md5": "4b3f5f8c9d578d3e38343999dc8c960e",
"sha256": "ef40cd04214ad9276f591ff64acad0900bec00e1fd640c964adffc2b8f1843a5"
},
"downloads": -1,
"filename": "acms-0.0.4.tar.gz",
"has_sig": false,
"md5_digest": "4b3f5f8c9d578d3e38343999dc8c960e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 24712,
"upload_time": "2025-10-28T00:36:59",
"upload_time_iso_8601": "2025-10-28T00:36:59.539601Z",
"url": "https://files.pythonhosted.org/packages/5c/55/3df154c23be0294ed1cc9e20439a5786e4a20a94209c5be59cdead3d9761/acms-0.0.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-28 00:36:59",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "gattjoe",
"github_project": "ACMS",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "fastmcp",
"specs": [
[
"==",
"2.12.5"
]
]
},
{
"name": "mcp",
"specs": [
[
"==",
"1.14.0"
]
]
},
{
"name": "pyjwt",
"specs": [
[
"==",
"2.10.1"
]
]
},
{
"name": "python-dotenv",
"specs": [
[
">=",
"1.1.0"
]
]
},
{
"name": "cryptography",
"specs": [
[
"==",
"46.0.3"
]
]
}
],
"lcname": "acms"
}
JSON
