About Shell Exec
Shell Exec is an MCP server published by domdomegg in the Developer Tools category: shell Execution MCP Server for Claude and other MCP-compatible AI assistants.
The repository has 9 stars and 2 forks, with the last commit 2 days ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
claude mcp add shell-exec -- npx -y shell-exec-mcpnpx -y shell-exec-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (2)
executeRun a bash command (with optional timeout and background mode)
Parameters not published.
get_job_statusCheck status of a background job
Parameters not published.
Ask AI
Ask AI about Shell Exec
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
shell-exec-mcp
MCP server for executing bash commands with background job support.
Use Cases
Run build commands: Execute npm run build, make, or other build tools and get the output.
File operations: Use find, grep, mv, rm, mkdir -p, stat etc. for file management.
Long-running tasks: Start servers or watch processes in background mode, check on them later.
System info: Run df -h, ps aux, env etc. to inspect the system state.
Setup
claude mcp add shell-exec-mcp -- npx -y shell-exec-mcp
Or with HTTP transport:
# Start the server
MCP_TRANSPORT=http PORT=3000 npx -y shell-exec-mcp
# Add to Claude
claude mcp add --transport http shell-exec-mcp http://localhost:3000/mcp
Tools
| Tool | Description |
|---|---|
execute |
Run a bash command (with optional timeout and background mode) |
get_job_status |
Check status of a background job |
Contributing
Pull requests are welcomed on GitHub! To get started:
- Install Git and Node.js
- Clone the repository
- Install dependencies with
npm install - Run
npm run testto run tests - Build with
npm run build
Releases
Versions follow the semantic versioning spec.
To release:
- Use
npm version <major | minor | patch>to bump the version - Run
git push --follow-tagsto push with tags - Wait for GitHub Actions to publish to the NPM registry.
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.