Command Security Layer

🚀 MCP Command Server

A secure Model Context Protocol (MCP) server for executing system commands via large language model applications like Claude.

🚀 Quick Start

Step 1: Install the Package

uv pip install mcp-command-server

Step 2: Configure Allowed Commands

export ALLOWED_COMMANDS="ls,pwd,echo"

Step 3: 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 a whitelist.
• ✅ User confirmation for all commands.
• 📝 Comprehensive audit logging.
• 🔍 Input validation and sanitization.
• 🤖 Integration with Claude Desktop.

📚 Documentation

For the full documentation, please check the docs/ directory:

• Installation Guide
• Security Guide
• API Reference
• Usage Examples
• Troubleshooting

📦 Installation

Step 1: Clone the Repository

git clone https://github.com/yourusername/mcp-command-server.git
cd mcp-command-server

Step 2: Create a Virtual Environment

# On Unix/macOS
uv venv
source .venv/bin/activate

# On Windows
uv venv
.venv\Scripts\activate

Step 3: Install Development Dependencies

uv pip install -e ".[dev]"

💻 Usage Examples

Basic Usage

# 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"
      }
    }
  }
}

🔧 Technical Details

Testing

# Run all tests
pytest

# Run a specific test file
pytest tests/unit/security/test_validator.py

# Run with coverage
pytest --cov=mcp_command_server

Contribution

1. Fork the repository.
2. Create a feature branch.
3. Run tests and code checks.
4. Submit a pull request.

📄 License

This project is under the MIT License. For details, see LICENSE.