Terminal Controller MCP Server

O que faz o MCP Server “Terminal Controller”?

O Terminal Controller MCP Server é um servidor Model Context Protocol (MCP) projetado para permitir a execução segura de comandos de terminal, navegação por diretórios e operações no sistema de arquivos por meio de uma interface padronizada. Ele atua como ponte entre assistentes de IA e o ambiente hospedeiro, permitindo que agentes de IA realizem tarefas como executar comandos shell, gerenciar diretórios e manipular arquivos de forma programática. Com proteções de segurança integradas, rastreamento de histórico de comandos e compatibilidade multiplataforma, o Terminal Controller aprimora os fluxos de trabalho de desenvolvimento ao conceder acesso controlado ao terminal e sistema de arquivos da máquina para ferramentas baseadas em IA. Esta capacidade permite que assistentes de IA automatizem, explorem e gerenciem tarefas em nível de sistema para desenvolvedores, de maneira segura e padronizada.

Lista de Prompts

Nenhum modelo de prompt foi encontrado no repositório ou na documentação.

Lista de Recursos

Nenhum recurso MCP explícito foi definido no repositório ou documentação.

Lista de Ferramentas

• Execução de Comandos: Permite rodar comandos de terminal com controle de tempo limite e captura de saída detalhada.
• Gerenciamento de Diretórios: Permite navegação e listagem de conteúdos de diretórios com formatação intuitiva.
• Operações em Arquivos: Suporta leitura, escrita, atualização, inserção e exclusão de conteúdo de arquivos com precisão em nível de linha.
• Histórico de Comandos: Rastreia e exibe execuções recentes de comandos para auditoria e repetição.

Casos de Uso deste MCP Server

• Execução Automatizada de Comandos: Desenvolvedores podem instruir assistentes de IA a executar comandos shell de forma segura para build, testes ou deploy de código, com captura de saídas e erros.
• Gerenciamento de Diretórios e Arquivos: Agentes de IA podem ajudar a organizar, explorar ou manipular arquivos e pastas, facilitando a automação da exploração do código ou configuração do ambiente.
• Scripting com Foco em Segurança: Proteções internas auxiliam na prevenção de comandos perigosos, reduzindo riscos ao conceder acesso ao terminal para IA.
• Monitoramento e Auditoria de Sistema: O recurso de histórico de comandos permite rastrear quais ações foram realizadas, auxiliando em auditorias e transparência do fluxo de trabalho.
• Desenvolvimento Multiplataforma: Ao suportar sistemas Windows e UNIX, o servidor MCP facilita experiências de desenvolvimento consistentes em ambientes diversos.

Como configurar

Windsurf

1. Certifique-se de que o Python 3.11+ está instalado.
2. Instale o pacote via PyPI:

   pip install terminal-controller
   

3. Edite o arquivo de configuração do Windsurf para adicionar o servidor MCP:

   {
     "mcpServers": {
       "terminal-controller": {
         "command": "python",
         "args": ["-m", "terminal_controller"]
       }
     }
   }
   

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

Claude

1. Instale o Python 3.11+ em sua máquina.
2. Para o Claude Desktop, instale via Smithery:

   npx -y @smithery/cli install @GongRzhe/terminal-controller-mcp --client claude
   

3. Alternativamente, instale via PyPI:

   pip install terminal-controller
   

4. Adicione o seguinte à configuração do Claude:

   {
     "mcpServers": {
       "terminal-controller": {
         "command": "python",
         "args": ["-m", "terminal_controller"]
       }
     }
   }
   

5. Reinicie o Claude Desktop e certifique-se de que o servidor MCP foi detectado.

Cursor

1. Certifique-se de que Node.js e Python 3.11+ estão instalados.
2. Instale o terminal-controller:

   pip install terminal-controller
   

3. Adicione o servidor MCP à sua configuração do Cursor:

   {
     "mcpServers": {
       "terminal-controller": {
         "command": "python",
         "args": ["-m", "terminal_controller"]
       }
     }
   }
   

4. Salve o arquivo e reinicie o Cursor.
5. Confirme a integração verificando a lista de ferramentas no Cursor.

Cline

1. Certifique-se de que o Python 3.11+ está disponível.
2. Instale o servidor MCP:

   pip install terminal-controller
   

3. Adicione o trecho abaixo à configuração do Cline:

   {
     "mcpServers": {
       "terminal-controller": {
         "command": "python",
         "args": ["-m", "terminal_controller"]
       }
     }
   }
   

4. Reinicie o Cline após salvar as alterações.
5. Teste rodando um comando simples pela interface MCP.

Protegendo Chaves de API

Se forem necessárias chaves de API ou segredos para sua configuração, utilize variáveis de ambiente em vez de inseri-las diretamente no código. Exemplo de configuração:

{
  "mcpServers": {
    "terminal-controller": {
      "command": "python",
      "args": ["-m", "terminal_controller"],
      "env": {
        "MY_API_KEY": "${MY_API_KEY_ENV_VAR}"
      },
      "inputs": {
        "api_key": "${MY_API_KEY_ENV_VAR}"
      }
    }
  }
}

Como usar este MCP dentro dos fluxos

Usando MCP no FlowHunt

Para integrar servidores MCP ao fluxo de trabalho do 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 sistema MCP, insira os detalhes do seu servidor MCP usando o seguinte formato JSON:

{
  "terminal-controller": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Depois de configurado, o agente de IA poderá usar este MCP como ferramenta e acessar todas as suas funções e capacidades. Lembre-se de alterar “terminal-controller” para o nome real do seu servidor MCP e ajustar a URL para o endereço do seu MCP.

Visão Geral

Com base no exposto, o Terminal Controller MCP fornece acesso essencial ao terminal e sistema de arquivos de forma segura, mas não possui modelos de prompt e recursos explícitos. Sua configuração é bem documentada e multiplataforma. Roots e sampling não são mencionados. No geral, é um servidor prático, seguro e relativamente simples para necessidades centrais de DevOps ou automação.

MCP Score