什麼是Shell Command MCP 服務器？

Shell Command MCP 服務器是一個基於模型上下文協議（MCP）的工具，允許您在一個安全且隔離的環境中運行Shell腳本和命令。它提供了多種執行模式，支持同步和異步操作，使您可以高效地處理任務。

如何使用Shell Command MCP 服務器？

通過簡單的配置和命令，您可以輕鬆地將本地文件掛載到容器中，並在其中運行腳本。無論是開發還是測試，這個工具都能滿足您的需求。

適用場景

適用於需要在隔離環境中運行Shell腳本的場景，例如CI/CD流水線、自動化測試、數據分析等。

主要功能

同步執行支持立即執行Shell命令，並等待其完成後再返回結果。

異步執行提供四種異步執行模式：完整通知、逐行通知、分塊通知和逐字符通知。

Kubernetes 工具集成內置kubectl、helm、kustomize和hemfile，方便管理Kubernetes集群。

隔離環境每個容器都運行在非root用戶下，確保安全性和隔離性。

優勢與侷限性

優勢

安全隔離的工作環境

支持多種執行模式

內置Kubernetes工具

用戶權限映射

侷限性

需要安裝Docker

對高級功能可能需要一定的技術背景

如何使用

安裝Docker

確保您的系統已安裝Docker，可以從[Docker官網](https://www.docker.com/)下載並安裝。

配置本地目錄

選擇一個目錄作為工作區，並將其掛載到容器中。

啟動容器

使用以下命令啟動Shell Command MCP服務器。

使用案例

運行Shell腳本在容器中運行一個簡單的Shell腳本。

掛載目錄並運行命令將本地目錄掛載到容器中，並運行命令。

常見問題

如何確保容器的安全性？

是否支持異步執行？

如何掛載本地目錄？

🚀 Shell 命令 MCP 服務器

這是一個 MCP（模型上下文協議）服務器，允許在 Docker 容器內執行 shell 命令。它提供了安全且隔離的工作環境，可運行命令，同時不授予對主機 Docker 守護進程的訪問權限。

🚀 快速開始

先決條件

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 接口運行 shell 腳本
- 同步執行
- 具有四種不同模式的異步執行
  - complete: 命令完成時通知
  - line: 每輸出一行通知
  - chunk: 每輸出一個數據塊通知
  - character: 每輸出一個字符通知
Kubernetes 工具包含：kubectl、helm、kustomize、hemfile
隔離的 Docker 容器環境，非 root 用戶
- 主機容器 userid/groupid 映射實現。這使得容器能夠以與主機相同的用戶身份運行，確保容器創建的文件具有與主機相同的所有者和權限。
- 將主機目錄掛載到容器的 /home/mcp 目錄中作為持久化存儲。它成為 AI 工作的家目錄。
- 如果主機目錄為空，則從容器中的備份初始文件開始。