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.

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

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.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Terminal Server
dillip285
A
security
A
license
A
quality
A secure server for executing terminal commands within predefined paths, allowing safe interaction by Large Language Models with operating system environments.
Last updated -
1
104
7
JavaScript
MIT License
Shell-MCP
kevinwatt
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
475
4
TypeScript
MIT License
MCP Code Sandbox Server
chrishayuk
-
security
F
license
-
quality
An 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 -
12
Python
Bash MCP (Master Control Program)
yannbam
-
security
F
license
-
quality
A TypeScript application that allows Claude to safely execute bash commands with security safeguards including whitelisted commands, directories, and comprehensive logging.
Last updated -
TypeScript

View all related MCP servers

MCP Command Server