MCP Command Server

MCP Command Server

A secure Model Context Protocol (MCP) server for executing system commands through LLM applications like Claude.

Quick Start

  1. Install the package:
uv pip install mcp-command-server
  1. Configure allowed commands:
export ALLOWED_COMMANDS="ls,pwd,echo"
  1. 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

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

License

MIT License - see LICENSE for details.

-
security - not tested
F
license - not found
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

A secure server that allows LLM applications like Claude to execute whitelisted system commands with user confirmation and comprehensive security features.

  1. Quick Start
    1. Features
      1. Documentation
        1. Development
          1. Setup
          2. Testing
          3. Contributing
        2. License

          Related MCP Servers

          • A
            security
            A
            license
            A
            quality
            A 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 -
            20
            143
            2
            TypeScript
            MIT License
          • A
            security
            A
            license
            A
            quality
            An MCP server that enables secure terminal command execution, directory navigation, and file system operations through a standardized interface for LLMs.
            Last updated -
            10
            23
            Python
            MIT License
            • Apple
          • -
            security
            F
            license
            -
            quality
            An MCP server that allows secure execution of macOS terminal commands through Claude or Roo Code with built-in security whitelisting and approval mechanisms.
            Last updated -
            1
            JavaScript
            • Apple
          • -
            security
            A
            license
            -
            quality
            An MCP server that enables secure execution of shell commands across Windows, macOS, and Linux with built-in whitelisting and approval mechanisms for enhanced security.
            Last updated -
            13
            JavaScript
            MIT License
            • Linux
            • Apple

          View all related MCP servers

          ID: q5rkxotu8n