MCP-PROCESS

MCP-PROCESS

Um servidor MCP (Model-Client-Protocol) que permite ao Claude acessar um shell. Esta integração permite que o Claude execute comandos e interaja com o seu sistema de arquivos por meio da linha de comando.

Aviso / Isenção de Responsabilidade

⚠️ CUIDADO ⚠️

Este projeto foi testado apenas com WSL (Subsistema Windows para Linux) e não foi validado para uso em produção. Usar este MCP dá ao Claude acesso direto ao seu sistema de arquivos e shell, o que apresenta riscos significativos de segurança:

• Ele pode potencialmente excluir ou modificar arquivos críticos
• Ele pode executar qualquer comando acessível ao usuário sob o qual é executado
• As medidas de segurança integradas (como a lista de palavras proibidas) podem ser contornadas

Isto é verdadeiramente uma caixa de Pandora - use por sua conta e risco. O autor não assume nenhuma responsabilidade por danos, perda de dados ou problemas de segurança resultantes do uso deste software.

É fortemente recomendado usá-lo apenas em um ambiente isolado ou controlado.

Recursos

• Execução de comandos estáticos
• Validação de comandos potencialmente perigosos
• Configuração flexível de filtragem de comandos e timeout

Pré-requisitos

• Python 3.10 ou superior (Python 3.11+ recomendado)
• WSL instalado e configurado
• No Windows, o pacote pywinpty é necessário
• No Linux/Mac, o pacote ptyprocess é necessário

Instalação

1. Clone o repositório:

git clone https://github.com/jrame/mcp-process.git
cd mcp-process

2. Instale o pacote:

pip install .

Ou para instalação de desenvolvimento:

pip install -e ".[dev]"

Configuração do Claude

Para usar este servidor MCP com o Claude, você precisa adicionar a seguinte configuração ao arquivo de configuração do Claude. Dependendo da sua instalação, este arquivo geralmente está localizado em:

%AppData%/Claude/claude_desktop_config.json

Adicione a seguinte seção:

"mcpServers": {
  "wsl": {
    "command": "mcp-process",
    "args": [
      "--process-path-args", "wsl.exe --cd /mnt/c/Users/YourName",
      "--filter-patterns", "\\x1b\\[[0-9;]*m",
      "--exec-name", "exec",
      "--exec-description", "Exécute une commande statique (ls pwd cat tree ps mkdir cp grep find git sed echo rg ...) et retourne son résultat",
      "--exec-timeout", "60"
    ]
  },
  "psql": {
    "command": "mcp-process",
    "args": [
      "--process-path-args", "psql.exe postgresql://postgres:password@localhost:5432/db",
      "--exec-name", "psql",
      "--exec-description", "Exécute une commande statique sql et retourne son résultat ex: -c \"SELECT * FROM table;\" ",
      "--exec-timeout", "120"
    ]
  }
}

Opção	Descrição	Valor Padrão
--process-path-args	Caminho para o processo do shell incluindo argumentos iniciais (ex.: wsl.exe --cd [dir])	wsl.exe --cd [current_dir]
--forbidden-words	Lista de palavras não permitidas em comandos	[several_default_items]
--filter-patterns	Padrões de regex para filtrar	["\x07", "\x1b\[25l"]
--exec-name	Nome personalizado para a ferramenta exec	exec
--exec-description	Descrição personalizada para a ferramenta exec	(ver padrão em args)
--exec-timeout	Timeout do comando (em segundos)	60

Exemplos de Filtros

Para filtrar sequências de cores ANSI:

--filter-patterns "\x1b\[[0-9;]*m"

Para filtrar títulos de terminal:

--filter-patterns "\x1b\]0;.*?\x07"

Uso

Depois de instalado e configurado, você pode pedir ao Claude para executar comandos WSL da seguinte forma:

Can you run the command "ls -la" in WSL?

Desenvolvimento

Para contribuir com o desenvolvimento:

1. Clone o repositório
2. Instale as dependências de desenvolvimento:

   pip install -e ".[dev]"
   

3. Execute os testes:

   pytest
   

Licença

MIT

Contato

Para quaisquer dúvidas, relatórios de bugs ou sugestões, por favor crie uma issue no repositório GitHub do projeto. Repositório GitHub: https://github.com/Metherlance/mcp-process

Projetos e Recursos Semelhantes

Aqui está uma lista de projetos semelhantes que também fornecem servidores MCP para acesso ao shell:

• mcp-server-commands - Um servidor MCP para executar comandos do sistema
• mcp-process-server - Uma implementação em TypeScript de um servidor MCP para shell
• mcp-server-shell - Um servidor MCP para interações com shell