Metadata-Version: 2.4
Name: ACMS
Version: 0.0.8
Summary: ACMS is a Model Context Protocol (MCP) server that provides programmatic access to Apple's container CLI tool on macOS.
Author-email: Joe Gatt <gattjoe@users.noreply.github.com>
License-Expression: Apache-2.0
Project-URL: homepage, https://github.com/gattjoe/ACMS
Project-URL: documentation, https://github.com/gattjoe/ACMS/blob/master/README.md
Project-URL: repository, https://github.com/gattjoe/ACMS
Project-URL: changelog, https://github.com/gattjoe/ACMS/blob/master/CHANGELOG.md
Keywords: AI, Apple, MCP, container
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastmcp>=2.13
Requires-Dist: mcp>=1.21
Dynamic: license-file

# ACMS (Apple Container MCP Server)

[![Downloads](https://pepy.tech/badge/acms/month)](https://pepy.tech/project/acms)
[![PyPI Version](https://img.shields.io/pypi/v/acms.svg)](https://pypi.org/project/acms/)
[![Python version](https://img.shields.io/pypi/pyversions/acms.svg)](https://pypi.org/project/acms/)

**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 [Container 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
