mcpField
A
ACMS

ACMS

Local
github.com/gattjoeCloud & Infra3Updated 44w ago
Repository

About ACMS

ACMS is an MCP server that provides programmatic access to Apple's container CLI on Macs with Apple Silicon. It can run locally or be accessed over HTTP/S, for clients that need to operate Apple containers through MCP.

Key features

  1. 01Access Apple's container CLI programmatically
  2. 02Run locally or over HTTP/S

Use cases

  1. 01Create an Ubuntu x64 container through an MCP client
  2. 02Expose container CLI access from a remote Mac

MCP support

Exposes programmatic access to Apple's container CLI to MCP clients. It can be configured over HTTP at the server's /mcp endpoint.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "gattjoe-acms": {
      "command": "uvx",
      "args": [
        "ACMS"
      ]
    }
  }
}
Run commanduvx ACMS

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypiACMS0.1.0

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

ACMS (Apple Container MCP Server)

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.

footgun

mcp-name: io.github.gattjoe/ACMS

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.