LingTerm MCP — Deixe a IA Controlar Seu Terminal com Segurança

Um tutorial prático. Após a leitura, você terá a IA executando comandos de terminal no Cursor ou Claude — com segurança.

O Que É?

Já desejou poder simplesmente dizer à IA "execute os testes" e ela faz? Ou dizer "mostre-me o log git recente" e receber o resultado de volta?

LingTerm faz exatamente isso — um servidor MCP que permite que assistentes de IA como Claude e Cursor executem comandos de terminal com segurança.

O principal ponto de venda: segurança. Em vez de dar à IA um shell bruto para atacar, ele usa uma defesa em três camadas: lista de permissões + lista de bloqueio + detecção de injeção, garantindo que a IA faça apenas o que deve.

Início Rápido

1. Instalar

Opção A: Execute com npx (recomendado)

Não é necessário clonar — basta usar npx na sua configuração MCP:

"ling-term-mcp": {
  "command": "npx",
  "args": ["-y", "ling-term-mcp"]
}

Opção B: Instalar a partir do código-fonte

git clone https://github.com/guangda88/ling-term-mcp.git
cd ling-term-mcp
npm install && npm run build

Ou use a linha única: bash quickstart.sh (verifica automaticamente o ambiente, instala dependências, compila e executa testes).

2. Conectar ao Cursor

Abra as Configurações do Cursor → Servidores MCP, adicione:

{
  "mcpServers": {
    "ling-term-mcp": {
      "command": "npx",
      "args": ["-y", "ling-term-mcp"]
    }
  }
}

Se instalar a partir do código-fonte, altere o comando para "node" e os argumentos para ["/seu/caminho/absoluto/ling-term-mcp/dist/index.js"]. Nota: o caminho deve ser absoluto.

Reinicie o Cursor.

3. Conectar ao Claude Desktop

Edite seu arquivo de configuração do Claude Desktop e adicione a mesma configuração mcpServers.

Reinicie o Claude Desktop.

4. Conectar via HTTP (Remoto / Multi-Cliente)

Stdio é ótimo para uso local, mas e se você quiser compartilhar uma instância do LingTerm entre vários clientes de IA? Ou conectar de uma máquina remota?

LingTerm suporta o HTTP Streamable — o padrão moderno do protocolo MCP para conexões baseadas em HTTP.

Inicie o servidor HTTP:

npx ling-term-mcp http
# → Ouvindo em http://127.0.0.1:9529/mcp

Conecte-se de qualquer cliente MCP que suporte transporte HTTP:

O endpoint MCP é http://127.0.0.1:9529/mcp. Configure seu cliente para usar esta URL como o endereço do servidor MCP.

Verificação de saúde:

curl http://127.0.0.1:9529/health
# → {"status":"ok"}

Configuração (variáveis de ambiente):

Segurando com um token:

export LING_TERM_AUTH_TOKEN="seu-token-secreto"
npx ling-term-mcp http

Os clientes devem incluir Authorization: Bearer seu-token-secreto nas requisições.

Quando usar HTTP vs Stdio:

5. Experimente

No Cursor ou Claude, diga:

Mostre-me quais arquivos estão no diretório atual

A IA invocará o LingTerm para executar ls -la (Linux/macOS) ou dir (Windows) e retornará o resultado. Assim simples.

Cinco Ferramentas — Suficientes para Uso Diário

LingTerm fornece 5 ferramentas MCP:

Para 90% do uso diário, execute_command é tudo o que você precisa. As outras 4 são para cenários de múltiplas sessões.

Cenários do Mundo Real

Cenário 1: Deixe a IA Executar Seus Testes Durante o Desenvolvimento

Execute os testes unitários do projeto

IA → npm test, retorna os resultados dos testes.

Mostre-me a cobertura dos testes

IA → npm run test:coverage, retorna o relatório de cobertura.

Cenário 2: Operações Git

Qual é o status atual do git?

IA → git status

Commits recentes

IA → git log --oneline -10

Em qual branch estou?

IA → git branch