Acms

🚀 ACMS (Apple Container MCP Server)

ACMS は、macOS上でAppleのコンテナCLIツールにプログラムからアクセスできるようにする、Model Context Protocol (MCP) サーバーです。ACMSはローカルで実行することも、HTTP/Sを介してリモートからアクセスすることもできます。

ACMSの目的は、Containerization パッケージと Container cli の取り組みに注目を集めることです。ACMSのインスピレーションは coderunner から得られました。

✨ 主な機能

• 9つの機能カテゴリーにまたがる50以上のコンテナ操作
• FastMCPを介したHTTP/WebSocketトランスポート 、最新の接続性を実現
• JSON文字列とネイティブ配列をサポートする堅牢なパラメータ検証
• 100%の機能がテスト済みの本番環境対応

📦 インストール

前提条件

• Apple Silicon搭載のMac
• macOS 26以上 - 制限事項 がありますが、Sequoiaでも実行可能です。
• Xcode 26 - containerizationをコンパイルするために必要です。
• Apple Containerization Framework - (コンテナ機能に必要)
• Apple Container Cli - インストールされ、PATHに含まれている必要があります。
• Python 3.8以上 - asyncioをサポートしている必要があります。

インストール手順

リポジトリをクローンするか、仮想環境で pip install acms を実行します。

Appleコンテナサービスの起動

# ほとんどの操作に必要
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 create an ubuntu x64 container ..."

🚀 クイックスタート

上記の手順に従って、ACMSをインストール、起動、設定します。

🧪 テスト

ACMSには包括的なエンドツーエンドテストが含まれています。Claudeに "ACMS CLAUDE TEST GUIDE" を実行するように指示するだけです。

🔒 セキュリティに関する考慮事項

このサーバーはセキュアではありません。特に、自宅ネットワーク上のリモートMac OSエンドポイントで実行する場合に注意が必要です。

mcp-name: io.github.gattjoe/ACMS