termix-mcp

Servidor MCP para o Termix, o gerenciador self-hosted de SSH/RDP/VNC. Deixa um agente (Claude Desktop, Claude Code, Cursor, VS Code...) listar e operar hosts, snippets, dashboard, metricas e auditoria do seu Termix, construido sobre o termix-sdk.

Nao e um wrapper 1:1 da API do Termix: e um conjunto curado de tools, seguro por padrao (sem segredos, sem sessao SSH persistente, sem tools destrutivas fora de toolsets explicitos).

Tambem disponivel no MCP Registry como io.github.sujirodev/termix-mcp.

Instalar

uvx termix-mcp

Alternativas: pip install termix-mcp ou a imagem ghcr.io/sujirodev/termix-mcp.

Requer uma API key do Termix (tmx_...) com permissao RBAC minima para o que o agente vai fazer - veja SECURITY.md.

Configurar no cliente

Claude Desktop / Claude Code (claude_desktop_config.json ou .mcp.json):

{
  "mcpServers": {
    "termix": {
      "command": "uvx",
      "args": ["termix-mcp"],
      "env": {
        "TERMIX_URL": "https://termix.example.com",
        "TERMIX_API_KEY": "tmx_xxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Cursor / VS Code: mesmo formato, no arquivo de configuracao MCP de cada um.

Voce diz / o que acontece

Variaveis de ambiente

Toolsets

Ligados por padrao: hosts, snippets, dashboard, metrics, system, audit.

Opt-in (TERMIX_MCP_TOOLSETS=hosts,files,docker,...): credentials, files, docker, tunnels, alerts, automations, users.

Desligados e explicitos (nunca entram em all): admin, dangerous.

TERMIX_MCP_READ_ONLY=true esconde e bloqueia toda tool que nao seja read-only, em qualquer toolset.

Tools

Contribuindo

Veja CONTRIBUTING.md.

Seguranca

Veja SECURITY.md para o modelo de ameaças.

Licenca

MIT