shell-command-mcp

shell-command-mcp

4

The Shell Command MCP Server is a Model Context Protocol server that enables executing shell commands securely within a Docker container. It supports synchronous and asynchronous command execution modes and includes Kubernetes tools, all within an isolated environment independent of the host's Docker daemon.

Shell Command MCP Server

This is an MCP server designed for executing shell commands within a Docker container, offering a secure and isolated workspace.

Features

  • Allows running shell scripts via MCP interface
    • Synchronous execution
    • Asynchronous execution with modes: complete, line, chunk, character
  • Kubernetes tools included: kubectl, helm, kustomize, hemfile
  • Isolated Docker container with non-root user
    • Host-container userid/groupid mapping for file permissions
    • Mount host directory for persistence

Design Philosophy

The server provides an AI workspace akin to a human environment, emphasizing container isolation and external authorization for security. It offers tools without requiring specialized knowledge.

Getting Started

  • Prerequisite: Docker

Usage with Claude for Desktop

Configuration is provided for MacOS and Windows to integrate with Docker.