Secure Shell Executor

🚀 MCP Shell Server

MCP Shell Server 是一個安全的服務器，用於執行授權的 shell 命令，並支持通過 stdin 傳遞輸入。它實現了模型上下文協議（MCP），允許遠程執行經過驗證的 shell 命令，為用戶提供了安全、高效的命令執行環境。

✨ 主要特性

• 安全命令執行：僅允許執行受信任的命令，保障系統安全。
• 標準輸入支持：可以通過 stdin 向命令提供輸入，增強命令執行的靈活性。
• 全面輸出：返回 stdout、stderr、退出狀態碼和執行時間，方便用戶瞭解命令執行情況。
• shell 操作符驗證：在使用 shell 操作符（;，&&，||，|）時仍需進行命令驗證，確保命令的合法性。
• 超時控制：為命令設置最大執行時間，避免命令長時間運行佔用資源。

📦 安裝指南

安裝依賴項

pip install -e ".[test]"

啟動服務器

uvicorn main:app --reload

驗證安裝

運行以下命令檢查是否成功安裝：

mcp-shell-server --version

💻 使用示例

基礎用法

示例 1：執行基本命令

請求示例：

{
  "command": ["echo", "Hello, World!"],
  "stdin": null,
  "directory": "/",
  "timeout": 30
}

響應示例：

{
  "stdout": "Hello, World!\n",
  "stderr": "",
  "status": 0,
  "execution_time": 0.123456
}

示例 2：帶有標準輸入的命令

請求示例：

{
  "command": ["tr", "a-z", "A-Z"],
  "stdin": "hello world\n",
  "directory": "/tmp",
  "timeout": 60
}

📚 詳細文檔

客戶端配置在 Claude.app 中

發佈版本

code ~/Library/Application\ Support/Claude/claude.yaml

backend:
  class: mcp_shell_server.Backend
  config:
    server_uri: http://localhost:5000
    max_timeout: 3600

本地版本

poetry install
poetry run mcp-shell-server

請求格式

請求參數

響應格式

🔧 技術細節

開發說明

設置開發環境

1. 克隆倉庫

git clone https://github.com/yourusername/mcp-shell-server.git
cd mcp-shell-server

2. 安裝依賴項（包括測試要求）

pip install -e ".[test]"

執行測試

pytest

API 參考文檔

請求參數

響應參數

系統要求

• Python 3.11 或更高版本
• mcp>=1.1.0

📄 許可證

MIT 許可證 - 請參閱 LICENSE 文件以獲取詳細信息。