MCP Command Server

MCP Command Server

Um servidor seguro de Model Context Protocol (MCP) para executar comandos do sistema por meio de aplicações LLM como o Claude.

Início Rápido

1. Instale o pacote:

uv pip install mcp-command-server

2. Configure os comandos permitidos:

export ALLOWED_COMMANDS="ls,pwd,echo"

3. Adicione à configuração do Claude Desktop:

{
  "mcpServers": {
    "command-server": {
      "command": "uv",
      "args": ["run", "python", "-m", "mcp_command_server"],
      "env": {
        "ALLOWED_COMMANDS": "ls,pwd,echo"
      }
    }
  }
}

Recursos

• 🔒 Execução segura de comandos com lista de permissões
• ✅ Confirmação do usuário para todos os comandos
• 📝 Registro de auditoria abrangente
• 🔍 Validação e sanitização de entrada
• 🤖 Integração com Claude Desktop

Documentação

Para documentação completa, consulte o diretório docs/:

• Guia de Instalação
• Diretrizes de Segurança
• Referência da API
• Exemplos de Uso
• Solução de Problemas

Desenvolvimento

Configuração

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

Testes

# Run all tests
pytest

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

# Run with coverage
pytest --cov=mcp_command_server

Contribuição

1. Faça um fork do repositório
2. Crie sua branch de funcionalidade
3. Execute os testes e a verificação de linting
4. Envie um pull request

Licença

Licença MIT - consulte LICENSE para detalhes.