Odysseus0 MCP Server Shell

🚀 Shell MCP 服務器

Shell MCP 服務器是一個基於模型上下文協議（Model Context Protocol）的服務器，它提供殼命令執行功能。藉助該服務器，大型語言模型（LLM）能夠以受控方式執行 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"]
  }
},

調試

您可以使用 MCP 監視器調試服務器。

• 對於 uvx 安裝：

npx @modelcontextprotocol/inspector uvx mcp-server-shell

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

cd path/to/servers/src/shell
npx @modelcontextprotocol/inspector uv mcp_server_shell

安全注意事項

• 輸入驗證：始終對用戶提供的輸入進行驗證，避免命令注入攻擊。
• 權限管理：限制服務器執行的命令權限，確保只有經過授權的操作被允許。

貢獻指南

要為該項目做出貢獻，請遵循以下步驟：

1. fork 倉庫
2. 創建功能分支
3. 提交更改
4. 推送到 fork
5. 提交拉取請求

如需報告問題或提出功能請求，請在 GitHub 上打開問題。

💻 使用示例

基礎用法

執行 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-server-shell！希望它能為您的項目提供強大的 shell 命令執行能力。