Mac Shell MCP

🚀 Mac Shell MCP サーバー

Mac Shell MCP サーバーは、macOS 用の拡張シェル機能を提供するツールです。MCP（Multi-Command Protocol） を統合することで、シェルコマンドの安全な管理と制御を実現します。

✨ 主な機能

このサーバーは以下の主要機能を提供します：

1. コマンド分類管理：シェルコマンドを3つのカテゴリーに分類します。安全に使用できるコマンド、承認が必要なコマンド、使用禁止のコマンドです。
2. 承認メカニズム：高リスクのコマンドに承認プロセスを設け、承認されたコマンドのみを実行できるようにします。
3. 権限制御：すべてのコマンドはサーバーを実行するユーザーの権限で実行され、privilege escalation 攻撃を防止します。
4. コマンドキューイング：承認待ちのコマンドは、承認または拒否されるまで一時的に保存されます。

📦 インストール

1. プロジェクトリポジトリをクローンします：

   git clone https://github.com/cfdude/mac-shell-mcp.git
   cd mac-shell-mcp
   

2. 依存関係をインストールしてビルドします：

   npm install
   npm run build
   

💻 使用例

基本的な使用法

サーバーの起動

node build/server.js

設定ガイド

npx を使用する場合

以下の設定を MCP 設定に追加します：

Brave Shell の場合

"mac-shell": {
  "command": "npx",
  "args": ["-y", "github:cfdude/mac-shell-mcp"],
  "alwaysAllow": [],
  "disabled": false
}

カスタムインストールの場合

1. npm パッケージとしてインストールします：

   npm install -g mac-shell-mcp
   

2. MCP 設定に追加します：

   "mac-shell": {
     "command": "mac-shell-mcp",
     "alwaysAllow": [],
     "disabled": false
   }
   

高度な使用法

デフォルト設定

安全に使用できるコマンド

• ls - ディレクトリの内容を表示します。
• pwd - 現在の作業ディレクトリを表示します。
• echo - テキストを標準出力に出力します。
• cat - ファイルの内容を表示します。
• grep - ファイル内でパターンを検索します。
• find - ディレクトリ階層を検索します。
• cd - ディレクトリを切り替えます。
• head - ファイルの先頭部分を出力します。
• tail - ファイルの末尾部分を出力します。
• wc - 行、単語、バイト数の統計を表示します。

承認が必要なコマンド

• mv - ファイルを移動または名前を変更します。
• cp - ファイルやディレクトリをコピーします。
• mkdir - 新しいディレクトリを作成します。
• touch - ファイルのタイムスタンプを変更するか、空のファイルを作成します。
• chmod - ファイルの権限を変更します。
• chown - ファイルの所有者とグループを変更します。

使用禁止のコマンド

• rm - ファイルやディレクトリを削除します。
• sudo - 他のユーザーとしてコマンドを実行します。

ホワイトリストの拡張

MCP ツール add_to_whitelist を使用して、新しい信頼できるコマンドを追加できます。例えば：

{
  "command": "npm",
  "securityLevel": "requires_approval",
  "description": "Node.js パッケージマネージャー"
}

📚 ドキュメント

セキュリティに関する注意事項

1. すべてのコマンドはサーバーを実行するユーザーの権限で実行されます。
2. 承認待ちのコマンドは、承認または拒否されるまで一時的に保存されます。
3. 使用禁止のコマンドは直接ブロックされ、エラーメッセージが表示されます。

プロジェクトリンク

• GitHub リポジトリ
• MCP プロトコルドキュメント