Meta Agent Tools
PT

Back to the catalog

io.github.gattjoe/ACMS

Apple Container MCP Server (ACMS) provides access to Apple's container CLI tool on macOS

Open source Open in the app JSON README (API)

About

Apple Container MCP Server (ACMS) provides access to Apple's container CLI tool on macOS

Details

Kind
MCP servers
Topic
Cloud & DevOps
Publisher
gattjoe
Origin
official
Category
ferramentas
Transport
local
Version
0.1.0
Stars
3
Forks
1
Last push
2025-12-22T03:01:46Z
Repository state
ativo
Language
Python
License
Apache-2.0
Added
2026-08-29 03:02:50
Updated
2026-08-29 03:02:50
Origin id
io.github.gattjoe/ACMS

README

# 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).

## 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

## Quick Start

### Install

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

### Start Apple Container Services
```bash

container system start

```

### 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. Also, you can lose your data when Claude tries to be helpful.

![footgun](./images/footgun.png)

mcp-name: io.github.gattjoe/ACMS

More