MCP Server Shell

🚀 Shell MCP 服務器

Shell MCP 服務器是一個基於模型上下文協議（Model Context Protocol）的服務器，它提供 shell 命令執行功能。藉助該服務器，大型語言模型能夠安全地執行 shell 命令並獲取其輸出。

✨ 主要特性

• 提供 execute_command 工具，可執行 shell 命令並返回輸出。
  • 必要參數：
    • command (字符串)：待執行的 shell 命令
  • 返回內容：
    • command：執行的命令
    • output：合併後的 stdout 和 stderr 輸出
    • return_code：命令執行返回碼

📦 安裝指南

使用 uv（推薦）

當使用uv時，無需進行特定安裝。我們將直接使用uvx運行 mcp-server-shell。

使用 pip 安裝

或者，您可以通過 pip 安裝 mcp-server-shell：

pip install mcp-server-shell

安裝完成後，可以作為腳本運行：

python -m mcp_server_shell

📚 詳細文檔

配置指南

配置用於 Claude.app

在您的 Claude 設置中添加：

"mcpServers": {
  "shell": {
    "command": "uvx",
    "args": ["mcp-server-shell"]
  }
}

"mcpServers": {
  "shell": {
    "command": "python",
    "args": ["-m", "mcp_server_shell"]
  }
}

配置用於 Zed

在您的 Zed settings.json 中添加：

"context_servers": {
  "mcp-server-shell": {
    "command": "uvx",
    "args": ["mcp-server-shell"]
  }
},

"context_servers": {
  "mcp-server-shell": {
    "command": "python",
    "args": ["-m", "mcp_server_shell"]
  }
},

示例交互

執行 shell 命令

{
  "name": "execute_command",
  "arguments": {
    "command": "ls -la"
  }
}

響應

{
  "command": "ls -la",
  "output": "total 24\ndrwxr-xr-x  5 user  group   160 Jan  1 12:00 .\ndrwxr-xr-x  3 user  group    96 Jan  1 12:00 ..",
  "return_code": 0
}

調試方法

您可以使用 MCP inspector 調試服務器。對於 uvx 安裝：

npx @modelcontextprotocol/inspector uvx mcp-server-shell

或者如果您在特定目錄安裝或開發此包：

cd path/to/servers/src/shell
npx @modelcontextprotocol/inspector uv run mcp-server-shell

示例問題（針對 Claude）

1. “當前目錄下有哪些文件？”
2. “顯示 README.md 文件的內容”
3. “當前系統的日期是什麼？”
4. “檢查 Python 是否已安裝並顯示其版本”

安全注意事項

⚠️ 重要提示

此服務器直接在本地執行 shell 命令。請確保輸入的命令是可信的，以防止潛在的安全風險。

貢獻指南

如需貢獻，請參考項目文檔或聯繫維護人員。

📄 許可證

[此處添加許可證信息]