MCP Bash

一个简单的模型-上下文-协议 (MCP) 服务器，用于执行 bash 命令。 此项目允许您通过 MCP 服务器接口执行 bash 命令，但存在所有潜在的安全风险！ 在撰写本文时，我没有在公共领域找到任何类似的东西，所以我自己写了一个。 当让 Claude Desktop 编写代码时，它是一个福音（它可以运行测试，评估结果并在一次通过中修复它发现的问题。）

描述

MCP Bash 提供了一种从客户端应用程序执行 bash 命令的简单方法。 它将命令执行包装在一个受控环境中，并返回执行命令的 stdout 和 stderr。

主要特点：

• 执行任意 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/<username>/Library/Application Support/Claude/claude_desktop_config.json，或者在 Claude Desktop UI 中查看“Settings -> Developer”）：

{
  "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 文件。

贡献

欢迎贡献！ 请随时提交 Pull Request。