JinDaGe - acms MCP Details

article

README

🚀 ACMS (Apple Container MCP Server)

ACMS 是一个模型上下文协议（MCP）服务器，它能让用户在 macOS 上以编程方式访问苹果的容器 CLI 工具。ACMS 既可以在本地运行，也能通过 HTTP/S 远程访问。该项目旨在引起大家对 Containerization 包和 Container cli 相关工作的关注。其灵感来源于 coderunner。

✨ 主要特性

50 多种容器操作：涵盖 9 个功能类别。
HTTP/WebSocket 传输：通过 FastMCP 实现现代连接。
强大的参数验证：支持 JSON 字符串和原生数组。
生产就绪：功能经过 100% 测试。

📦 安装指南

前提条件

搭载苹果芯片的 Mac
macOS 26+：它可以在 Sequoia 上运行，但存在限制。
Xcode 26：编译 containerization 时需要。
苹果容器化框架：（容器功能必需）
苹果容器 CLI：已安装并添加到环境变量 PATH 中。
Python 3.8+：支持 asyncio。

安装步骤

可以克隆仓库，也可以在虚拟环境中使用 pip install acms 进行安装。

启动苹果容器服务

# 大多数操作都需要此步骤
container system start

# 验证系统状态
container system status

启动 ACMS 服务器

# 推荐：使用启动脚本
./start-acms.sh

# 或者使用自定义选项直接启动
python3 acms/acms.py --port 8765 --host 127.0.0.1 > acms.log 2>&1 &

配置 MCP 客户端

将以下内容添加到 MCP 客户端配置中：

claude mcp add --transport http acms http://localhost:8765/mcp

🚀 快速开始

按照上述安装指南完成安装和配置后，即可开始使用 ACMS。

💻 使用示例

"acms create an ubuntu x64 container ..."

🧪 测试

ACMS 包含全面的端到端测试，只需让 Claude 运行 “ACMS CLAUDE TEST GUIDE” 即可。

⚠️ 安全注意事项

该项目存在安全风险，尤其是在家庭网络中的远程 Mac OS 端点上运行时。

mcp 名称：io.github.gattjoe/ACMS

acms