シェルコマンド MCP サーバー

これは、Dockerコンテナ内でシェルコマンドを実行できるMCP（Model Context Protocol）サーバーです。ホストのDockerデーモンにアクセスさせることなく、コマンドを実行するための安全で隔離されたワークスペースを提供します。

特徴

シンプルなMCPインターフェースを介してシェルスクリプトを実行する
- 同期実行
- 4つの異なるモードによる非同期実行
  - 完了: コマンドが完了したら通知する
  - 行: 出力の各行を通知する
  - chunk: 出力の各チャンクごとに通知する
  - 文字: 出力の各文字を通知する
含まれる Kubernetes ツール: kubectl、helm、kustomize、hemfile
非ルートユーザーによる分離された Docker コンテナ環境
- ホストとコンテナ間のユーザー ID/グループ ID のマッピングが実装されました。これにより、コンテナをホストと同じユーザーとして実行できるようになり、コンテナによって作成されたファイルに、ホストによって作成されたファイルと同じ所有権と権限が与えられるようになります。
- 永続性のために、ホストディレクトリをコンテナの /home/mcp ディレクトリにマウントします。これが AI が動作するホームディレクトリになります。
- ホストディレクトリが空の場合、初期ファイルはコンテナー内のバックアップからコピーされます。

デザイン哲学

このMCPサーバーは、AIに人間と同様の作業空間を提供します。認証はMCPの機能ではなく、コンテナの分離と外部認証の制限によって制限されます。

シェルスクリプト実行などのより一般的なツールも提供しており、ツールの使用に関する専門知識がなくても使用できます。

コード監査を容易にするために、サーバーの実装は可能な限りシンプルに保たれています。

はじめる

前提条件

ドッカー

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コンテナで使用できるようにするディレクトリに置き換えます。

ウィンドウズ:

"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ツール

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

MCPサーバーはコンテナ内で非ルートユーザーとして実行される
コンテナはホストDockerデーモンにアクセスできません
ユーザーワークスペースは永続性のためにホストからマウントされます

ライセンス

マサチューセッツ工科大学

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

execute-command

Claude の MCP インターフェースを介して安全な Docker コンテナ内でシェルコマンドを実行できるようにし、ホスト Docker デーモンにアクセスせずに Kubernetes ツールと分離された環境を提供します。

Related Resources

Reddit Discussion about this server

Related MCP Servers

k8s-interactive-mcp
TaichiHo
A
security
F
license
A
quality
A MCP server that can run Kubernetes commands with a given kubeconfig path and provide interpretation of the commands.
Last updated -
1
2
JavaScript
Sandbox MCP Server
Tsuchijo
-
security
F
license
-
quality
Provides isolated Docker environments for code execution, enabling users to create and manage containers, execute multi-language code, save and reproduce development environments, ensuring security and isolation.
Last updated -
6
Python
mcp-shell-server
tumf
A
security
A
license
A
quality
A secure shell command execution server implementing the Model Context Protocol (MCP). This server allows remote execution of whitelisted shell commands with support for stdin input.
Last updated -
1
74
Python
MIT License
Docker MCP Server
suvarchal
-
security
F
license
-
quality
Allows Claude and other AI assistants to interact with Docker through the MCP protocol, enabling container and image management including listing, running, stopping, and pulling Docker resources.
Last updated -
2
JavaScript

View all related MCP servers

Shell Command MCP Server