MCP 服务器

Shell Command MCP Server

允许通过 Claude 的 MCP 接口在安全的 Docker 容器内执行 shell 命令，提供 Kubernetes 工具和隔离环境，而无需访问宿主机的 Docker 守护进程。

Tools

execute-command

# execute-command This tool executes shell command on bash. Each command execution spawn a new bash process.

README

Shell Command MCP 服务器

这是一个 MCP (模型上下文协议) 服务器，允许在 Docker 容器内执行 shell 命令。它提供了一个安全且隔离的工作区，用于运行命令，而无需访问宿主机 Docker 守护进程。

特性

通过简单的 MCP 接口运行 shell 脚本
- 同步执行
- 异步执行，具有 4 种不同的模式
  - complete: 命令完成时通知
  - line: 在每行输出时通知
  - chunk: 在每个输出块时通知
  - character: 在每个字符输出时通知
包含 Kubernetes 工具：kubectl, helm, kustomize, hemfile
具有非 root 用户的隔离 Docker 容器环境
- 实现了宿主机-容器 userid/groupid 映射。这允许容器以与宿主机相同的用户身份运行，确保容器创建的文件具有与宿主机创建的文件相同的属主和权限。
- 将宿主机目录挂载到容器的 /home/mcp 目录以实现持久化。它成为 AI 工作的主目录。
- 如果宿主机目录为空，则初始文件将从容器中的备份复制。

设计理念

此 MCP 服务器为 AI 提供了一个类似于人类的工作区。授权不是由 MCP 功能限制，而是由容器隔离和外部授权限制。

它提供了更通用的工具，例如 shell 脚本执行，以便可以在不具备工具使用专业知识的情况下使用它们。

服务器实现尽可能简单，以方便代码审计。

快速开始

前提条件

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"
   ]
}