mcp-command-server

View on GitHub

0 stars PythonServers & Infrastructure Updated Jan 30, 2025

Documentation

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:

bash

uv pip install mcp-command-server

2. Configure allowed commands:

bash

export ALLOWED_COMMANDS="ls,pwd,echo"

3. Add to Claude Desktop configuration:

json

{
  "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

bash

# 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

bash

# 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.

Frequently asked questions

What is mcp-command-server?

mcp-command-server is a Model Context Protocol (MCP) server listed in the TrackMCP directory.

How do I install mcp-command-server?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is mcp-command-server open source?

Yes — it is hosted on GitHub at https://github.com/andrew-beniash/mcp-command-server.

Related MCP tools

damn-vulnerable-mcp-server

Damn Vulnerable MCP Server Python-based implementation. Trusted by 1200+ developers. Trusted by 1200+ developers. Trusted by 1200+ developers.

1,209 Python

mysql_mcp_server

A Model Context Protocol (MCP) server that enables secure interaction with MySQL databases Python-based implementation. Trusted by 900+ developers.

964 Python

aimcpmodel-context-protocol+1

supabase-mcp-server

Query MCP enables end-to-end management of Supabase via chat interface: read & write query executions, management API support, automatic migration versioning...

805 Python

cursormodel-context-protocolsupabase+1