Shell Command MCP Server
by kaznak
This is an MCP server that allows executing shell commands within a Docker container. It provides a secure and isolated workspace for running commands without giving access to the host Docker daemon.
Last updated: N/A
What is Shell Command MCP Server?
The Shell Command MCP Server is a tool that enables the execution of shell commands within an isolated Docker container, accessible through the Model Context Protocol (MCP). It provides a secure environment for AI or other applications to run shell scripts without direct access to the host system.
How to use Shell Command MCP Server?
To use the server, configure your application (e.g., Claude for Desktop) with the provided Docker run command, specifying a host directory to mount as the container's home directory. Then, interact with the server using the available MCP tools to execute bash scripts synchronously or asynchronously.
Key features of Shell Command MCP Server
Run shell scripts through MCP interface (sync/async)
Asynchronous execution with different notification modes (complete, line, chunk, character)
Includes Kubernetes tools (kubectl, helm, kustomize, hemfile)
Isolated Docker container environment with non-root user and host-container userid/groupid mapping
Mount a host directory for persistent storage
Use cases of Shell Command MCP Server
Allowing AI to execute shell commands in a controlled environment
Automating tasks within a Docker container
Providing a secure workspace for running potentially risky scripts
Integrating shell scripting capabilities into MCP-based applications
FAQ from Shell Command MCP Server
What is MCP?
What is MCP?
MCP stands for Model Context Protocol. It is a protocol that allows different applications to communicate and share context.
How does the server ensure security?
How does the server ensure security?
The server runs as a non-root user within an isolated Docker container, preventing direct access to the host system. User workspace is mounted from the host for persistence.
What Kubernetes tools are included?
What Kubernetes tools are included?
The server includes kubectl, helm, kustomize, and hemfile.
How do I configure the mounted directory?
How do I configure the mounted directory?
You need to modify the Docker run command in your application's configuration file to specify the host directory you want to mount as the container's /home/mcp directory.
What happens if the host directory is empty?
What happens if the host directory is empty?
If the host directory is empty, the initial files will be copied from the backup in the container.