A
securityA
licenseA
qualityA secure server for executing terminal commands within predefined paths, allowing safe interaction by Large Language Models with operating system environments.
Last updated -
1
38
13
MIT License
MCP Command Server
A secure Model Context Protocol (MCP) server for executing system commands through LLM applications like Claude.
Quick Start
Install the package:
uv pip install mcp-command-server
Configure allowed commands:
export ALLOWED_COMMANDS="ls,pwd,echo"
Add to Claude Desktop configuration:
{
"mcpServers": {
"command-server": {
"command": "uv",
"args": ["run", "python", "-m", "mcp_command_server"],
"env": {
"ALLOWED_COMMANDS": "ls,pwd,echo"
}
}
}
}
Features
🔒 Secure command execution with whitelist
✅ User confirmation for all commands
📝 Comprehensive audit logging
🔍 Input validation and sanitization
🤖 Claude Desktop integration
Documentation
For complete documentation, see the docs/ directory:
Development
Setup
# Clone repository
git clone https://github.com/yourusername/mcp-command-server.git
cd mcp-command-server
# Create virtual environment
uv venv
source .venv/bin/activate # On Unix/macOS
.venv\Scripts\activate # On Windows
# Install development dependencies
uv pip install -e ".[dev]"
Testing
# Run all tests
pytest
# Run specific test file
pytest tests/unit/security/test_validator.py
# Run with coverage
pytest --cov=mcp_command_server
Contributing
Fork the repository
Create your feature branch
Run tests and linting
Submit a pull request
License
MIT License - see LICENSE for details.
Related MCP Servers
- AsecurityAlicenseAqualityA secure MCP server for executing whitelisted shell commands with resource and timeout controls, designed for integration with Claude and other MCP-compatible LLMs.Last updated -20576MIT License
- -securityFlicense-qualityAn extensible Message Communication Protocol server that provides secure code execution capabilities in isolated sandbox environments, compatible with Claude for Desktop and other MCP clients.Last updated -13
- -security-license-qualityA TypeScript application that allows Claude to safely execute bash commands with security safeguards including whitelisted commands, directories, and comprehensive logging.