Cloudera Manager MCP Server (somente leitura)

Servidor MCP em Python (FastMCP + httpx) que expõe a API REST do Cloudera Manager para o Claude (Desktop, Claude Code ou qualquer cliente MCP). Só faz GET: não há nenhuma tool de start/stop/restart/alteração de configuração.

Tools (18)

As respostas são resumidas (campos relevantes) e truncadas em CM_MCP_MAX_CHARS para não estourar o contexto do modelo.

Related MCP server: datahub-cm-mcp

Pré-requisitos

• Python 3.10+

• Acesso de rede da máquina que roda o MCP até o CM (porta 7183/7180)

• Usuário dedicado no CM com role Read-Only (Administration → Users & Roles)

Instalação

git clone <seu-repo>/cm-mcp-server.git   # ou descompacte o zip
cd cm-mcp-server
python3 -m venv .venv && source .venv/bin/activate
pip install -e .
cp .env.example .env    # edite com seus valores

Teste rápido de conectividade com o CM antes de plugar no Claude:

curl -su mcp_readonly https://cm01.cliente.local:7183/api/version

Claude Desktop (stdio)

Edite o claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

{
  "mcpServers": {
    "cloudera-manager": {
      "command": "/caminho/absoluto/cm-mcp-server/.venv/bin/cm-mcp-stdio",
      "env": {
        "CM_HOST": "cm01.cliente.local",
        "CM_USE_TLS": "true",
        "CM_VERIFY_SSL": "/caminho/para/ca-bundle.pem",
        "CM_USERNAME": "mcp_readonly",
        "CM_PASSWORD": "********"
      }
    }
  }
}

No Windows o comando fica C:\\caminho\\cm-mcp-server\\.venv\\Scripts\\cm-mcp-stdio.exe. Reinicie o Claude Desktop e as 18 tools aparecem no menu de ferramentas.

Claude Code

claude mcp add cloudera-manager \
  -e CM_HOST=cm01.cliente.local -e CM_USERNAME=mcp_readonly -e CM_PASSWORD=*** \
  -- /caminho/absoluto/cm-mcp-server/.venv/bin/cm-mcp-stdio

Modo HTTP (opcional)

set -a; source .env; set +a
cm-mcp-http      # escuta em http://127.0.0.1:8000/mcp

⚠️ O modo HTTP não tem autenticação própria. Mantenha em 127.0.0.1 ou coloque atrás de um reverse proxy com TLS e autenticação antes de expor na rede. Para usar como connector remoto no claude.ai, o endpoint precisa estar acessível pela internet, o que normalmente não é aceitável para o CM de um cliente; prefira stdio local.

Variáveis de ambiente

Exemplos de perguntas

• "Quais serviços do Cluster1 não estão saudáveis e por quê?"

• "Mostra as últimas 300 linhas do stderr do ResourceManager que está com problema."

• "Quais configs do Impala foram alteradas em relação ao default?"

• "Qual foi o pico de CPU dos hosts na última hora?" (tsquery select cpu_percent where category = HOST)

• "Teve algum evento CRITICAL de HDFS nas últimas 12 horas?"

• "Quem reiniciou serviços ontem?" (auditoria)

Segurança

• O código só executa GET. Mesmo assim, use um usuário Read-Only: é a garantia real.

• Logs e configs podem conter dados sensíveis do cliente e vão para o contexto do modelo. Avalie com o cliente antes de usar em produção.

• Configurações marcadas como sensitive no CM já vêm mascaradas pela própria API.

• Não versione o .env.

Próximos passos possíveis

• Tools de escrita (restart de role, refresh de config) atrás de uma flag CM_ALLOW_WRITE=true e confirmação explícita.

• Integrações com YARN RM / Spark History / Impala Daemon web UIs para diagnóstico de jobs.

Licença

Distribuído sob a Apache License 2.0. Veja também o arquivo NOTICE.

Cloudera e Cloudera Manager são marcas da Cloudera, Inc. Este projeto não é afiliado nem endossado pela Cloudera.