Shell Command MCP Server

🚀 Shell コマンド MCP サーバー

このサーバーは MCP（モデルコンテキストプロトコル）サーバーで、Docker コンテナ内でシェルコマンドを実行できます。ホストの Docker デーモンへのアクセスを許可せずに、コマンドを実行するための安全で隔離された作業環境を提供します。

✨ 主な機能

• シンプルな MCP インターフェースを通じてシェルスクリプトを実行
  • 同期実行
  • 4 種類の異なるモードでの非同期実行
    • complete: コマンドが完了したときに通知
    • line: 出力が 1 行ごとに通知
    • chunk: 出力が 1 データブロックごとに通知
    • character: 出力が 1 文字ごとに通知
• Kubernetes ツールを含む：kubectl、helm、kustomize、hemfile
• 隔離された Docker コンテナ環境で、root ユーザーではなく動作
  • ホストコンテナの userid/groupid マッピングが実装されています。これにより、コンテナはホストと同じユーザーとして実行でき、コンテナで作成されたファイルはホストと同じ所有者と権限を持ちます。
  • ホストディレクトリをコンテナの /home/mcp ディレクトリにマウントして永続的なストレージとします。これが AI 作業のホームディレクトリになります。
  • ホストディレクトリが空の場合、コンテナ内のバックアップ初期ファイルから開始します。

📚 ドキュメント

この MCP サーバーは、AI に人間に似た作業環境を提供します。 承認は MCP 機能の制限ではなく、コンテナの隔離と外部の承認制限によって実現されます。 シェルスクリプトの実行など、より汎用的なツールを提供するため、ツールの使用方法を特別に学ばなくても利用できます。 サーバーの実装はできるだけシンプルに保たれ、コードレビューを促進します。

🚀 クイックスタート

前提条件

• Docker

Claude for Desktop との連携

以下の設定を Claude for Desktop の設定ファイルに追加します。

MacOS:

"shell-command": {
  "command": "docker",
  "args": [
    "run",
    "--rm",
    "-i",
    "--mount",
    "type=bind,src=/Users/user-name/MCPHome,dst=/home/mcp",
    "ghcr.io/kaznak/shell-command-mcp:latest"
  ]
}

/Users/user-name/ClaudeWorks をコンテナで利用可能にしたいディレクトリに置き換えてください。

Windows:

"shell-command": {
   "command": "docker",
   "args": [
      "run",
      "--rm",
      "-i",
      "--mount",
      "type=bind,src=\\\\wsl.localhost\\Ubuntu\\home\\user-name\\MCPHome,dst=/home/mcp",
      "ghcr.io/kaznak/shell-command-mcp:latest"
   ]
}

ヒント

マウントされたディレクトリ内でファイルを操作します。

💻 使用例

基本的な使用法

利用可能な MCP ツール:

• execute-bash-script-sync
• execute-bash-script-async

🔧 技術詳細

• MCP サーバーはコンテナ内で root ユーザーではなく動作します。
• コンテナはホストの Docker デーモンへのアクセス権を持っていません。
• ユーザーの作業領域はホストからマウントされ、永続的なストレージとして使用されます。

📄 ライセンス

MIT