Execute shell commands without permission prompts.
A simple MCP (Model Context Protocol) server that enables Claude to execute shell commands without permission prompts.
⚠️ Security Warning: This server executes arbitrary shell commands. Use with caution and only in trusted environments.
# Install globally
npm install -g bash-mcp
# Or use with npx
npx bash-mcp
Add to your claude_desktop_config.json
:
{
"mcpServers": {
"bash": {
"command": "npx",
"args": ["bash-mcp"]
}
}
}
bash-mcp
run
- Execute a command// Simple command
run("ls -la")
// With working directory
run("npm test", { cwd: "/path/to/project" })
// With timeout (milliseconds)
run("long-running-command", { timeout: 60000 })
run_background
- Start a background process// Start a dev server
run_background("npm run dev", "frontend")
// Start backend service with working directory
run_background("./gradlew bootRun", "backend", { cwd: "./backend" })
kill_background
- Stop a background processkill_background("frontend")
list_background
- List all background processeslist_background()
User: Start the development servers
Assistant: I'll start both frontend and backend servers for you.
[Uses run_background tool]
Started frontend server (PID: 12345)
Started backend server (PID: 12346)
User: Check if they're running
Assistant: [Uses list_background tool]
Both servers are running successfully!
All tools return JSON formatted responses:
{
"success": true,
"stdout": "command output",
"stderr": "error output if any",
"command": "executed command"
}
For background processes:
{
"success": true,
"name": "frontend",
"pid": 12345,
"command": "npm run dev",
"message": "Started background process 'frontend' (PID: 12345)"
}
BASH_MCP_MAX_OUTPUT_SIZE
: Maximum output size in bytes before truncation (default: 51200/50KB)BASH_MCP_TEMP_DIR
: Directory for storing full output when truncated (default: system temp directory){
"mcpServers": {
"bash": {
"command": "npx",
"args": ["bash-mcp"],
"env": {
"BASH_MCP_MAX_OUTPUT_SIZE": "102400",
"BASH_MCP_TEMP_DIR": "/tmp/bash-mcp-outputs"
}
}
}
}
When command output exceeds BASH_MCP_MAX_OUTPUT_SIZE
:
This MCP server executes arbitrary shell commands with the same privileges as the Node.js process. Only use in development environments or trusted contexts.
MIT
tinywind tinywind0@gmail.com
Issues and pull requests are welcome at GitHub.
Provides LLMs with essential random generation abilities, built entirely on Python's standard library.
Integration with QA Sphere test management system, enabling LLMs to discover, summarize, and interact with test cases directly from AI-powered IDEs
Provides real-time access to Chainlink's decentralized on-chain price feeds.
MCP Language Server gives MCP enabled clients access to semantic tools like get definition, references, rename, and diagnostics.
Enable AI Agents to fix Playwright test failures reported to Currents.
Single tool to control all 100+ API integrations, and UI components
Run Python in a code sandbox.
Tools to query latest Maven dependency information
Provides multi-cluster Kubernetes management and operations using MCP, It can be integrated as an SDK into your own project and includes nearly 50 built-in tools covering common DevOps and development scenarios. Supports both standard and CRD resources.
MCP Server to control and interact with Unity3d Game Engine for game development