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.

「開発者ツール」の他のコンテンツ

BetterBugs

The BetterBugs MCP (Model Context Protocol) enables you to load BetterBugs bug reports (via report links) directly to your preferred AI Agents and developer environments with MCP Client capabilities (such as Cursor, VS C

ArtiBot Cloud MCP - Zhijiangyun 智匠云

bofob

ArtiBot Cloud MCP (Zhijiangyun 智匠云) — cloud MCP server for robot manipulation data & GPU workloads. 15 tools: robot fleet management, data collection & video recording, post-processing pipelines, and benchmark evaluation

OrangePro

Aamir Siddiqui

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

Nebelus

Nebelus is an enterprise agentic-AI platform for regulated industries. This MCP server exposes the Nebelus Construction API: ~48 tools that give an MCP client full agent build parity — create/update/probe agents, edit ag

FARPY

mangomunchr

Verified distributed compute for humans, applications, and agents. Submit Blender, Octane, and video workloads, route them across qualified GPUs, track asynchronous execution, download finished artifacts, and verify FARP