@justmpm/term-manager

MCP Server para terminais Windows sem timeout. Permite que agentes de IA criem, monitorem e controlem terminais persistentes — comandos longos continuam rodando mesmo enquanto a IA faz outras tarefas.

Arquitetura

• node-pty (ConPTY) — Gerencia os processos reais, capturando output e enviando input
• Buffer de 2000 linhas por terminal, texto limpo sem códigos ANSI

Tools

| Tool | Descrição | |------|-----------| | create_terminal | Cria terminal persistente — comandos longos/background sem timeout | | list_terminals | Lista terminais criados, ativos ou finalizados | | close_terminal | Finaliza um terminal e libera recursos | | read_output | Lê as últimas N linhas do output (snapshot) | | search_output | Busca texto no output (substring, case-insensitive) | | send_input | Envia texto/sequência de controle para terminal ativo |

Instalação

npx (sem instalar)

{
  "mcpServers": {
    "term-manager": {
      "command": "npx",
      "args": ["-y", "@justmpm/term-manager"]
    }
  }
}

Desenvolvimento local

cd mcps-ai/term-manager
npm install && npm run build

{
  "mcpServers": {
    "term-manager": {
      "command": "node",
      "args": ["D:/Pictures/Pacotes-Pessoais/mcps-ai/term-manager/dist/index.js"]
    }
  }
}

Requisitos

• Node.js >= 18
• Windows 10 1809+ (para ConPTY)

Stack

| Dependência | Versão | Uso | |-------------|--------|-----| | TypeScript | ^5.9.3 | Linguagem principal (strict mode) | | node-pty | ^1.0.0 | Gerenciamento de terminais (ConPTY) | | @modelcontextprotocol/sdk | ^1.26.0 | MCP server e transporte stdio | | zod | ^3.24.0 | Validação de schemas de input |

Licença

MIT © Koda AI Studio