ssh-mcp-server: SSH Remoto Seguro para Fluxos de Trabalho de IA

O que faz o Servidor MCP “ssh-mcp-server”?

ssh-mcp-server é uma ferramenta de integração que permite que assistentes de IA e outras aplicações compatíveis com o Model Context Protocol (MCP) executem comandos SSH remotos por uma interface padronizada. Atuando como intermediário seguro, possibilita que assistentes de IA operem servidores remotos, executem comandos e obtenham resultados sem expor diretamente as credenciais SSH aos modelos de IA. O servidor suporta múltiplos métodos de conexão SSH segura, incluindo autenticação por senha e chave privada (com suporte opcional a passphrase). Oferece controles de segurança de comandos através de mecanismos de blacklist e whitelist, além de permitir transferência bidirecional de arquivos entre servidores locais e remotos. O ssh-mcp-server foi projetado para integração fluida em fluxos de desenvolvimento, proporcionando a desenvolvedores e agentes de IA acesso poderoso e controlado a sistemas remotos para tarefas como manutenção, automação e deploy.

Lista de Prompts

Nenhum template de prompt é explicitamente mencionado na documentação disponível.

Lista de Recursos

Nenhum recurso explícito está documentado nos arquivos disponíveis ou README.

Lista de Ferramentas

• execute-command
  Ferramenta de Execução de Comandos: Execute comandos SSH em servidores remotos e obtenha os resultados.
• upload
  Ferramenta de Upload de Arquivos: Envie arquivos locais para locais especificados em servidores remotos.
• download
  Ferramenta de Download de Arquivos: Baixe arquivos de servidores remotos para locais especificados no seu computador.

Casos de Uso deste Servidor MCP

• Gerenciamento Remoto de Servidores
  Permite que desenvolvedores ou agentes de IA executem comandos administrativos ou de manutenção em servidores remotos com segurança, como reiniciar serviços, verificar logs ou atualizar softwares.
• Deploy Automatizado
  Facilita pipelines de deploy automatizado, permitindo que scripts ou fluxos de IA façam push de código, executem scripts de instalação ou gerenciem aplicações via SSH.
• Sincronização de Arquivos
  Suporta transferência bidirecional de arquivos, facilitando o upload de arquivos de configuração ou download de logs e resultados de servidores remotos.
• Auditoria de Segurança
  Permite a execução controlada de comandos de auditoria (usando whitelist/blacklist), possibilitando verificações de segurança e validação de compliance sem risco de danos ao sistema.
• Isolamento de Credenciais
  Garante operação segura ao nunca expor as credenciais SSH ao modelo de IA, reduzindo riscos em ambientes sensíveis.

Como configurar

Windsurf

1. Pré-requisitos: Certifique-se de que Node.js e npx estão instalados.
2. Localize a Configuração: Abra o arquivo de configuração do Windsurf.
3. Adicione o Servidor MCP: Insira o seguinte trecho JSON no objeto mcpServers:

   {
     "mcpServers": {
       "ssh-mpc-server": {
         "command": "npx",
         "args": [
           "-y",
           "@fangjunjie/ssh-mcp-server",
           "--host 192.168.1.1",
           "--port 22",
           "--username root",
           "--password pwd123456"
         ]
       }
     }
   }
   

4. Salve e Reinicie: Salve o arquivo e reinicie o Windsurf.
5. Verifique a Configuração: Teste executando um comando SSH simples via interface MCP.

Claude

1. Pré-requisitos: Node.js e npx devem estar disponíveis.
2. Localize a Configuração: Abra a configuração mcpServers do Claude.
3. Adicione o Servidor MCP: Use a configuração abaixo:

   {
     "mcpServers": {
       "ssh-mpc-server": {
         "command": "npx",
         "args": [
           "-y",
           "@fangjunjie/ssh-mcp-server",
           "--host 192.168.1.1",
           "--port 22",
           "--username root",
           "--privateKey ~/.ssh/id_rsa"
         ]
       }
     }
   }
   

4. Salve e Reinicie: Salve as alterações e reinicie o Claude.
5. Verifique a Configuração: Faça um teste usando a integração MCP do Claude.

Cursor

1. Pré-requisitos: Instale Node.js e npx.
2. Edite a Configuração: Acesse o diretório de configuração do Cursor e edite o arquivo adequado.
3. Adicione o Servidor MCP: Insira:

   {
     "mcpServers": {
       "ssh-mpc-server": {
         "command": "npx",
         "args": [
           "-y",
           "@fangjunjie/ssh-mcp-server",
           "--host 192.168.1.1",
           "--port 22",
           "--username root",
           "--privateKey ~/.ssh/id_rsa",
           "--passphrase pwd123456"
         ]
       }
     }
   }
   

4. Reinicie o Cursor: Salve e reinicie o Cursor.
5. Verifique: Use o painel de comandos MCP para validar a conexão SSH remota.

Cline

1. Pré-requisitos: Certifique-se de que Node.js e npx estão instalados.
2. Abra a Configuração: Edite a seção mcpServers na configuração do Cline.
3. Adicione o Servidor MCP: Adicione:

   {
     "mcpServers": {
       "ssh-mpc-server": {
         "command": "npx",
         "args": [
           "-y",
           "@fangjunjie/ssh-mcp-server",
           "--host 192.168.1.1",
           "--port 22",
           "--username root",
           "--password pwd123456",
           "--whitelist ^ls( .*)?,^cat .*,^df.*"
         ]
       }
     }
   }
   

4. Salve e Reinicie: Salve a configuração e reinicie o Cline.
5. Teste a Conexão: Valide executando um comando permitido.

Protegendo as Chaves de API

Para evitar expor credenciais em arquivos de configuração, utilize variáveis de ambiente:

{
  "mcpServers": {
    "ssh-mpc-server": {
      "command": "npx",
      "args": [
        "-y",
        "@fangjunjie/ssh-mcp-server",
        "--host ${SSH_HOST}",
        "--port ${SSH_PORT}",
        "--username ${SSH_USER}",
        "--password ${SSH_PASSWORD}"
      ],
      "env": {
        "SSH_HOST": "192.168.1.1",
        "SSH_PORT": "22",
        "SSH_USER": "root",
        "SSH_PASSWORD": "pwd123456"
      }
    }
  }
}

Como usar este MCP em fluxos

Usando MCP no FlowHunt

Para integrar servidores MCP ao seu fluxo FlowHunt, comece adicionando o componente MCP ao seu fluxo e conectando-o ao seu agente de IA:

Clique no componente MCP para abrir o painel de configuração. Na seção de configuração MCP do sistema, insira os detalhes do seu servidor MCP usando este formato JSON:

{
  "ssh-mpc-server": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Depois de configurado, o agente de IA poderá usar este MCP como ferramenta, com acesso a todas as suas funções e capacidades. Lembre-se de alterar “ssh-mpc-server” para o nome real do seu servidor MCP e atualizar a URL.

Visão Geral

Nossa opinião

O ssh-mcp-server fornece funcionalidades SSH essenciais como servidor MCP, com foco em segurança e praticidade. Seu conjunto de ferramentas é prático para diversos cenários de desenvolvimento e automação, mas carece de recursos avançados como recursos, templates de prompt ou suporte a sampling. A documentação é clara para configuração e uso operacional. No geral, é uma utilidade sólida e especializada para acesso SSH seguro via MCP.

Pontuação MCP

NOTA: 5/10

O ssh-mcp-server tem pontuação moderada, destacando-se na integração SSH segura e exposição das ferramentas principais, mas falta suporte a recursos e prompts, e não documenta roots ou sampling. Sua licença open source e configuração clara são pontos positivos, mas permanece uma solução MCP focada, não abrangente.