MCP.so
登录

MCP Bash

@patrickomatik

基本信息

分类

开发工具

许可证

MIT

传输方式

stdio

作者

patrickomatik

关于 MCP Bash

A simple model context protocol (MCP) server that allows Claude Desktop or other MCP aware clients to run Bash commands on your local machine.

#mcp-bash#bash-server#mcp-client

MCP Bash 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-bash": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        ".venv"
      ]
    }
  }
}

MCP Bash 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表,不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is MCP Bash?

MCP Bash is a Model-Context-Protocol server that allows client applications to execute arbitrary bash commands and receive stdout/stderr output. It wraps command execution in a controlled environment, supports setting and maintaining a working directory across invocations, and is designed for use with AI assistants like Claude Desktop to automate code testing and file operations.

How to use MCP Bash?

Install Python 3.10+, clone the repository, create a virtual environment, and install with pip install -e .. Start the server with python -m mcp.cli.server --module server. For Claude Desktop, add the provided JSON configuration to claude_desktop_config.json. Use the set_cwd(path) and execute_bash(cmd) functions via the MCP client API.

Key features of MCP Bash

  • Execute arbitrary bash commands
  • Set and maintain a working directory across command executions
  • Clean interface through the Model-Context-Protocol
  • Simple to deploy and extend

Use cases of MCP Bash

  • Run tests, assess results, and fix code issues in one pass with Claude Desktop
  • List files or perform file system operations from an AI assistant
  • Automate system administration tasks via a controlled MCP interface
  • Integrate bash command execution into custom MCP client applications

常见问题

1

What can MCP Bash do?

It executes bash commands and returns both stdout and stderr. You can also change the working directory so subsequent commands run in the same context.

2

What are the security risks?

The server executes bash commands directly, which can be dangerous (e.g., `rm -rf /`). The README recommends running in a container or restricted environment, adding command validation, or limiting filesystem access.

3

What are the runtime requirements?

Python 3.10 or higher and pip. For Claude Desktop, the `uv` package manager is used in the provided configuration.

4

How do I configure MCP Bash for Claude Desktop?

Add the JSON snippet from the README to your Claude Desktop configuration file (`claude_desktop_config.json`), replacing paths with your own. Then ask Claude: "List the files in my current directory using the Bash MCP tool."

5

Are there any built-in command restrictions?

No. The server has no built-in allowlist or validation; it executes any bash command as given. All security measures must be implemented externally.

评论

开发工具 分类下的更多 MCP 服务器