mcp-ia-web

Servidor MCP (Model Context Protocol) que dá a uma IA acesso ao seu terminal local (CMD / PowerShell / bash) e a torna capaz de agir como um agente local — parecido com o que o Claude Code e o Antigravity fazem.

A sessão é persistente: o diretório de trabalho é mantido entre comandos, então a IA pode navegar pelo sistema, rodar builds, scripts, git, etc.

⚠️ Aviso de segurança. Este servidor executa comandos arbitrários na sua máquina. Trate-o como acesso total ao seu terminal. Só exponha o modo HTTP à rede/internet com MCP_AUTH_TOKEN definido e, de preferência, atrás de um túnel seguro (Cloudflare Tunnel, ngrok, VPN). Para limitar o alcance use MCP_ALLOWED_DIR (jail) e MCP_BLOCKED_PATTERNS.

Ferramentas expostas

Related MCP server: Terminal MCP Server

Instalação

# (recomendado) crie um ambiente virtual
python -m venv .venv
# Windows:  .venv\Scripts\activate
# Linux/mac: source .venv/bin/activate

pip install -r requirements.txt
# ou instale como pacote (cria o comando `mcp-ia-web`):
pip install -e .

Como rodar

1) Modo local (stdio) — para Claude Desktop / Claude Code

Este é o modo mais seguro: a IA roda no seu próprio computador e fala com o servidor por stdin/stdout.

Configuração no Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "ia-web": {
      "command": "python",
      "args": ["-m", "mcp_ia_web.server"],
      "cwd": "C:/caminho/para/mcp-ia-web/src",
      "env": { "MCP_TRANSPORT": "stdio", "MCP_SHELL": "auto" }
    }
  }
}

No Claude Code:

claude mcp add ia-web -- python -m mcp_ia_web.server

2) Modo HTTP — para uma IA web acessar pela rede

# defina um token forte!
export MCP_TRANSPORT=http
export MCP_AUTH_TOKEN="troque-por-um-token-forte"
export MCP_HOST=0.0.0.0
export MCP_PORT=8000
python -m mcp_ia_web.server

O endpoint MCP fica em http://<host>:8000/mcp. Clientes (ex.: conectores de IA web) devem enviar o header Authorization: Bearer <seu-token>.

Para acessar de fora da sua máquina com segurança, use um túnel:

cloudflared tunnel --url http://localhost:8000
# ou
ngrok http 8000

E aponte a IA web para a URL pública gerada + /mcp.

Configuração (variáveis de ambiente)

Veja .env.example. Principais:

Roadmap

v1 entrega execução de comandos (núcleo do pedido). Próximos passos sugeridos: edição de arquivos, operações git dedicadas e busca na web — para se aproximar ainda mais de um agente completo como o Claude Code.