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 no terminal no Cursor ou Claude — com segurança.

Início Rápido

1. Instalar

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

Nenhum clone necessário — apenas use 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 Configurações do Cursor → Servidores MCP, adicione:

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

Se estiver instalando 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 Streamable HTTP — 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):

Segurança 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 tão simples.

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

Cenário 3: Solução de Problemas

Quem está usando a porta 3000?

IA → lsof -i :3000 ou netstat -tlnp | grep 3000

Quanto espaço em disco resta?

IA → df -h

Mostre-me as últimas 20 linhas do log de erro do nginx

IA → tail -20 /var/log/nginx/error.log

Cenário 4: Gerenciamento de Múltiplas Sessões

Você está trabalhando em um projeto de frontend e um de backend:

Crie uma sessão chamada "frontend" com diretório de trabalho ~/projects/web
Crie uma sessão chamada "backend" com diretório de trabalho ~/projects/api

As sessões registram o diretório de trabalho e os metadados das variáveis de ambiente por sessão, facilitando a troca de contextos.

Exemplo de Fluxo de Trabalho: Uma Tarefa Completa de Desenvolvimento

Coloque meu projeto em funcionamento

A IA executará um fluxo de trabalho em várias etapas:

1. git clone https://github.com/your/project.git  → clonar o repositório
2. cd project && npm install                        → instalar dependências
3. npm test                                         → executar testes