mcp-server-commands MCP Server

O que faz o “mcp-server-commands” MCP Server?

O mcp-server-commands MCP (Model Context Protocol) Server atua como uma ponte entre assistentes de IA e a capacidade de executar comandos locais ou do sistema com segurança. Ao expor uma interface para execução de comandos de shell, ele permite que clientes de IA acessem dados externos, interajam com o sistema de arquivos, realizem diagnósticos ou automatizem fluxos de trabalho diretamente de seu ambiente. O servidor processa requisições de comando de LLMs e retorna a saída, incluindo tanto o STDOUT quanto o STDERR, que podem ser usados para análises ou ações adicionais. Isso aprimora fluxos de desenvolvimento ao possibilitar tarefas como listar diretórios, visualizar informações do sistema ou rodar scripts, expandindo assim as capacidades práticas de assistentes de IA para desenvolvedores e usuários avançados.

Lista de Prompts

• run_command – Gera uma mensagem de prompt com a saída do comando.

Lista de Recursos

Nenhum recurso explícito está listado na documentação ou código disponível.

Lista de Ferramentas

• run_command – Executa um comando especificado (ex: hostname, ls -al, echo "hello world"). Retorna STDOUT e STDERR como texto. Suporta um parâmetro opcional stdin para passar entrada (como código ou conteúdo de arquivos) para comandos que aceitam, facilitando operações de scripting e arquivos.

Casos de Uso deste MCP Server

• Diagnóstico de Sistema: Execute comandos como hostname ou top para obter o status do sistema ou detalhes do ambiente diretamente do assistente de IA.
• Gerenciamento de Arquivos: Liste diretórios (ls -al), crie ou leia arquivos e manipule arquivos de texto usando comandos de shell.
• Execução de Scripts: Execute scripts ou trechos de código (ex: Python, Bash) passando-os via stdin, permitindo prototipagem rápida ou automação.
• Automação de Desenvolvimento: Automatize tarefas repetitivas como puxar código, compilar projetos ou rodar testes via comandos de shell emitidos pela IA.
• Aprovação Segura de Comandos: Integre com ferramentas como Claude Desktop para garantir que cada comando seja revisado e aprovado antes da execução, minimizando riscos de segurança.

Como configurar

Windsurf

1. Certifique-se de que Node.js e npm estão instalados.
2. Instale o pacote mcp-server-commands:

   npm install -g mcp-server-commands
   

3. Edite seu arquivo de configuração do Windsurf para adicionar o MCP server.
4. Adicione o seguinte trecho JSON:

   {
     "mcpServers": {
       "mcp-server-commands": {
         "command": "npx",
         "args": ["mcp-server-commands"]
       }
     }
   }
   

5. Salve a configuração e reinicie o Windsurf.
6. Verifique se o servidor está rodando e acessível.

Claude

1. Certifique-se de que Node.js e npm estão instalados.
2. Instale o mcp-server-commands globalmente:

   npm install -g mcp-server-commands
   

3. Localize o arquivo de configuração do Claude Desktop:
   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json
4. Adicione:

   {
     "mcpServers": {
       "mcp-server-commands": {
         "command": "npx",
         "args": ["mcp-server-commands"]
       }
     }
   }
   

5. Salve e reinicie o Claude Desktop.
6. Confirme que o MCP server aparece e está funcional.

Cursor

1. Instale Node.js e npm se necessário.
2. Instale mcp-server-commands globalmente:

   npm install -g mcp-server-commands
   

3. Abra seu arquivo de configuração do Cursor.
4. Insira:

   {
     "mcpServers": {
       "mcp-server-commands": {
         "command": "npx",
         "args": ["mcp-server-commands"]
       }
     }
   }
   

5. Salve as alterações e reinicie o Cursor.
6. Verifique se o MCP server está disponível para uso.

Cline

1. Certifique-se de que Node.js/npm estão instalados.
2. Instale o pacote do MCP server:

   npm install -g mcp-server-commands
   

3. Edite a configuração do MCP server do Cline.
4. Adicione:

   {
     "mcpServers": {
       "mcp-server-commands": {
         "command": "npx",
         "args": ["mcp-server-commands"]
       }
     }
   }
   

5. Salve e reinicie o Cline.
6. Verifique a conectividade com o MCP server.

Protegendo Chaves de API

Se precisar fornecer variáveis de ambiente sensíveis (ex: chaves de API), use os campos env e inputs na sua configuração:

{
  "mcpServers": {
    "mcp-server-commands": {
      "command": "npx",
      "args": ["mcp-server-commands"],
      "env": {
        "EXAMPLE_API_KEY": "${EXAMPLE_API_KEY}"
      },
      "inputs": {
        "apiKey": "${EXAMPLE_API_KEY}"
      }
    }
  }
}

Substitua EXAMPLE_API_KEY pelo nome real da sua variável de ambiente.

Como usar este MCP em fluxos

Usando MCP no FlowHunt

Para integrar MCP servers 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 do MCP do sistema, insira os detalhes do seu MCP server usando este formato JSON:

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

Uma vez configurado, o agente de IA poderá usar este MCP como uma ferramenta com acesso a todas as suas funções e capacidades. Lembre-se de alterar “mcp-server-commands” para o nome real do seu MCP server e substituir a URL pela URL do seu próprio MCP server.

Visão Geral

Nossa opinião:
Este MCP server é simples, mas altamente eficaz em seu propósito: dar acesso ao shell do sistema para LLMs de forma controlada. É bem documentado, fácil de configurar e possui alertas de segurança claros. No entanto, seu escopo é limitado (uma ferramenta, sem recursos explícitos ou templates de prompt além do run_command) e recursos MCP avançados como Roots e Sampling não são referenciados na documentação ou código. No geral, é bem indicado para desenvolvedores que buscam acesso ao shell via IA, mas carece de maior extensibilidade.

MCP Score