MCP Bash

🚀 MCP Bash

MCP Bash 是一個簡單的模型上下文協議（MCP）服務器，可用於執行 bash 命令。它允許用戶通過 MCP 服務器接口執行任意 bash 命令，不過這也伴隨著潛在的安全風險。由於在開發時未找到公開可用的類似工具，因此開發了此項目。它在使用 Claude Desktop 編寫代碼時十分實用，Claude Desktop 可以運行測試、評估結果並修復發現的問題。

🚀 快速開始

MCP Bash 提供了一種簡單的方式，讓客戶端應用程序能夠執行 bash 命令。它將命令執行封裝在受控環境中，並返回所執行命令的標準輸出和標準錯誤。

✨ 主要特性

• 可執行任意 bash 命令。
• 能夠設置並保持跨命令執行的工作目錄。
• 通過模型上下文協議（MCP）提供簡潔的接口。
• 部署簡單，且易於擴展。

📦 安裝指南

先決條件

• Python 3.10 或更高版本。
• pip 或其他包管理器。

設置

1. 克隆倉庫

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

2. 創建並激活虛擬環境

   python -m venv .venv
   source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate
   

3. 安裝依賴項

   pip install -e .
   

💻 使用示例

基礎用法

啟動服務器

python -m mcp.cli.server --module server

與 Claude Desktop 配置結合使用

要在與 Claude Desktop 結合使用時，將以下內容添加到您的配置中（通常位於 /Users//Library/Application Support/Claude/claude_desktop_config.json，或在 Claude Desktop UI 中查看“設置 -> 開發人員”）：

{
  "mcpServers": {
    "Bash": {
      "command": "/Users/<username>/.local/bin/uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "/path/to/server.py"
      ]
    }
  }
}

然後要求 Claude：“使用 Bash MCP 工具列出我的當前目錄中的文件”

高級用法

使用 API

服務器公開了兩個主要功能：

1. set_cwd(path)：設置 bash 命令的工作目錄。
2. execute_bash(cmd)：執行 bash 命令並返回 stdout/stderr。

示例客戶端代碼

from mcp.client import MCPClient

async def main():
    # 連接到 MCP 服務器
    client = MCPClient("http://localhost:8000")
    
    # 設置工作目錄
    await client.set_cwd("/path/to/your/directory")
    
    # 執行命令
    stdout, stderr = await client.execute_bash("ls -la")
    
    print(f"命令輸出：{stdout}")
    if stderr:
        print(f"錯誤輸出：{stderr}")

if __name__ == "__main__":
    import asyncio
    asyncio.run(main())

📚 詳細文檔

安全注意事項

此服務器直接執行 bash 命令，若不加以限制，可能存在嚴重的安全風險。大語言模型（LLM）無法阻止運行危險命令（如 rm -rf /）。對於個人使用，其實用性可能超過風險，但在部署時請務必謹慎。

考慮以下安全措施：

• 在容器或受限環境中運行。
• 添加命令驗證或允許列表。
• 使用適當的用戶權限限制文件系統訪問。

📄 許可證

該項目在 MIT 許可證下發布 - 有關詳細信息，請參閱 LICENSE 文件。

🤝 貢獻

歡迎貢獻！請隨意提交拉取請求。