Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
shell-exec-mcpclaude mcp add shell-exec -- npx -y shell-exec-mcp@1.2.0
{
"mcpServers": {
"shell-exec": {
"command": "npx",
"args": [
"-y",
"shell-exec-mcp@1.2.0"
]
}
}
}
shell-exec-mcpclaude mcp add shell-exec -e 'MCP_TRANSPORT=<MCP_TRANSPORT>' -- npx -y shell-exec-mcp@1.2.0
{
"mcpServers": {
"shell-exec": {
"command": "npx",
"args": [
"-y",
"shell-exec-mcp@1.2.0"
],
"env": {
"MCP_TRANSPORT": "<MCP_TRANSPORT>"
}
}
}
}
Variables d'environnement
MCP_TRANSPORTobligatoire Transport type.
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
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
Follow the instructions on install-mcp, which generates the right config for your MCP client (Claude Code, Claude Desktop, Cursor, Cline, VS Code, and more).
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.
Questions fréquentes
Qu'est-ce que Shell Exec ?
Execute bash commands with background job support.
Comment installer Shell Exec ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add shell-exec -- npx -y shell-exec-mcp@1.2.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour Shell Exec ?
Oui. Il attend MCP_TRANSPORT, à renseigner dans sa configuration.
Shell Exec est-il open source ?
Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.
Qui maintient Shell Exec ?
Il est publié par domdomegg. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.