Process Manager MCP

Gerenciar processos do sistema (iniciar, parar, reiniciar, monitorar) via uma interface MCP com limpeza automática.

Documentação

procm-mcp

Um servidor Model Context Protocol (MCP) para gerenciamento de processos.

Recursos suportados

  • Criação de processos segura e automatizável
  • Limpeza automática de processos criados ao encerrar (por exemplo, ao sair do claude code)
  • Recursos comuns de gerenciamento de processos suportados: reiniciar, excluir, verificar status ou recuperar stdout/stderr de processos

Usando esses recursos, LLMs iniciam processos como servidores de desenvolvimento, docker-compose ou observadores de testes e verificam suas saídas para corrigir bugs automaticamente.

Instalação

npm i -D procm-mcp

.mcp.json

{
  "mcpServers": {
    "procm-mcp": {
      "command": "node",
      "args": ["./node_modules/procm-mcp/build/index.js"],
      "env": {}
    }
  }
}

Criação segura de processos

Você pode permitir que LLMs usem a ferramenta start-process sem confirmação, porque o procm-mcp só permite criações de processos na lista de permissões.

LLMs pedirão que você use a ferramenta allow-start-process para adicionar uma criação de processo específica à lista de permissões.

Depois de permitir uma criação de processo, você não precisa mais confirmá-la, desde que o comando e o diretório de trabalho sejam os mesmos.

Eu chamo isso de "padrão allow-x", que equilibra segurança e usabilidade no MCP.

Aviso: Não permita que LLMs usem allow-start-process sem confirmação. Isso significa "Faça o que quiser".

Ferramentas

  • allow-start-process Permitir que processos específicos sejam criados
    • script (obrigatório): O script/comando a ser permitido
    • args (opcional): Matriz de argumentos
    • cwd (opcional): Diretório de trabalho
  • start-process Iniciar um novo processo com script e argumentos especificados
    • script (obrigatório): O script/comando a ser executado
    • name (opcional): Um nome amigável para o processo
    • args (opcional): Matriz de argumentos a serem passados ao script
    • cwd (obrigatório): Diretório de trabalho para o processo
    • envs (opcional): Variáveis de ambiente a serem definidas para o processo
  • delete-process Parar e remover um processo por ID. O sinal padrão é SIGTERM, mas SIGKILL (forçar encerramento) será enviado após 10 segundos, a menos que o processo saia.
    • id (obrigatório): O ID do processo
  • restart-process Reiniciar um processo existente por ID
    • id (obrigatório): O ID do processo
  • get-process-info Obter informações detalhadas sobre um processo
    • id (obrigatório): O ID do processo
  • list-processes Listar todos os processos atualmente gerenciados
    • Nenhum parâmetro necessário
  • get-process-stdout Recuperar logs de stdout de um processo
    • id (obrigatório): O ID do processo
    • chunkCount (opcional): Número de entradas de log recentes a recuperar (padrão: 10)
  • get-process-stderr Recuperar logs de stderr de um processo
    • id (obrigatório): O ID do processo
    • chunkCount (opcional): Número de entradas de log recentes a recuperar (padrão: 10)

Licença

MIT