Customable - MCPs
Repositories
49
 Projects Packages
17

@customable/shell-mcp (1.0.5)

Published 2025-10-07 17:10:28 +02:00 by jack in customable-mcp/shell-mcp

Installation

@customable:registry=
npm install @customable/shell-mcp@1.0.5
"@customable/shell-mcp": "1.0.5"

About this package

💻 shell-mcp

MCP Server for secure shell command execution with whitelist support.

Features

Core Operations

  • ⚡ run_command - Execute shell commands
  • 📋 get_logs - Retrieve command logs
  • ❌ cancel_command - Cancel running command
  • 📊 get_command_status - Check command status
  • 📝 list_presets - List available command presets

Security Features

  • Command whitelist
  • Configurable allowed commands
  • Timeout management
  • Working directory restrictions
  • Command output streaming

Predefined Presets

  • PHP: composer install, composer update, phpstan analyse, phpunit
  • Node.js: npm install, npm run build, npm test
  • Docker: docker ps, docker-compose up, docker-compose down
  • Git: git status, git log, git diff

Installation

npm install
npm run build

Usage

npm start

Configuration

Set environment variables:

  • ALLOWED_COMMANDS - Comma-separated list of allowed commands (e.g., "npm,composer,git")
  • ALLOWED_DIRS - Comma-separated list of allowed working directories
  • COMMAND_TIMEOUT - Command timeout in milliseconds (default: 300000 = 5min)

Security

⚠️ Important: Only use this MCP in trusted environments. Command execution can be dangerous if not properly configured.

License

MIT

Dependencies

Dependencies

ID Version
@modelcontextprotocol/sdk ^0.5.0
zod ^3.23.8

Development dependencies

ID Version
@types/node ^22.0.0
typescript ^5.5.0

Keywords

mcp shell command-execution mcp-server
Details
npm
customable-mcp/shell-mcp
2025-10-07 17:10:28 +02:00
1
Customable Team
Project website
MIT
11 KiB
Assets (1)
shell-mcp-1.0.5.tgz 11 KiB
Versions (2) View all
2.0.0 2025-10-10
1.0.5 2025-10-07
Issues