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

常见问题

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.

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.

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.

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."

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 服务器

Mcp-Warden

ermoluk

Local-first credential broker for MCP. AI coding agents (Claude Code, Cursor, Codex…) call APIs, SSH and databases through scoped presets; secrets stay in your OS keychain and never enter the agent's context.

SayLive

SayLIive

Publish the website your AI assistant just built, straight from the conversation. Static sites, your own domain, one payment, no subscription.

Official Porkbun MCP Server

Porkbun LLC

Official Porkbun MCP server, maintained by Porkbun. Check domain availability and pricing, register, renew and transfer domains, and manage DNS records, nameservers, URL forwarding, glue records, DNSSEC and domain contac

JiCo for Jira & Confluence – PII-redacting MCP server with Human-in-the-Loop

drkv-com

JiCo for Jira & Confluence: local MCP server for Jira Data Center - redacts personal data before the AI model, holds every write for approval

OrangePro

Aamir Siddiqui

OrangePro local-first CLI + MCP server for behavior mapping, grounded test generation, and dynamic proof.