Render MCP Server

Interaja com recursos do Render via LLMs usando a API do Render.

GitHub
165
Experimente este MCPPatrocinado

Documentação

Render MCP Server

Visão Geral

O Render MCP Server é um servidor Model Context Protocol (MCP) que permite que você interaja com seus recursos do Render por meio de LLMs.

Primeiros Passos

Comece com o servidor MCP seguindo a documentação oficial: https://render.com/docs/mcp-server

Casos de Uso

  • Criar e gerenciar web services, sites estáticos, cron jobs e bancos de dados no Render
  • Monitorar logs de aplicação e status de deployments para ajudar a solucionar problemas
  • Monitorar métricas de desempenho de serviços para depuração, planejamento de capacidade e otimização
  • Consultar seus bancos de dados Postgres diretamente dentro de um LLM

Feedback

Envie seu feedback abrindo uma issue no GitHub se tiver alguma solicitação de funcionalidade, relatório de bug, sugestão, comentário ou preocupação.

Ferramentas

Workspaces

  • list_workspaces - Lista os workspaces aos quais você tem acesso

    • Nenhum parâmetro necessário

  • select_workspace - Seleciona um workspace para usar

    • ownerID: O ID do workspace a ser selecionado (string, obrigatório). Mantido como ownerID para que chamadores existentes desta ferramenta obsoleta continuem funcionando; novo código deve passar workspaceId em cada chamada de ferramenta de recurso.

  • get_selected_workspace - Obtém o workspace atualmente selecionado

    • Nenhum parâmetro necessário

Cada ferramenta de recurso também aceita um workspaceId opcional. Após o usuário confirmar um workspace de list_workspaces, passe esse workspaceId em cada chamada de ferramenta relacionada. Isso mantém o workspace de destino explícito entre reconexões MCP e mudanças de sessão de transporte. Se workspaceId for omitido, o servidor usa temporariamente como fallback o workspace selecionado na sessão MCP atual. Esse comportamento implícito baseado em sessão está obsoleto e está programado para remoção.

Serviços

  • list_services - Lista todos os serviços na sua conta do Render

    • includePreviews: Se deve incluir preview services, o padrão é false (boolean, opcional)

  • get_service - Obtém detalhes sobre um serviço específico

    • serviceId: O ID do serviço a ser recuperado (string, obrigatório)

  • create_web_service - Cria um novo web service na sua conta do Render

    • name: Um nome exclusivo para o seu serviço (string, obrigatório)
    • runtime: Ambiente de execução para o seu serviço (string, obrigatório). Valores aceitos:
      • node
      • python
      • go
      • rust
      • ruby
      • elixir
      • docker
    • buildCommand: Comando usado para compilar seu serviço (string, obrigatório)
    • startCommand: Comando usado para iniciar seu serviço (string, obrigatório)
    • repo: Repositório contendo o código-fonte (string, opcional)
    • branch: Ramo do repositório para fazer deploy (string, opcional)
    • plan: Plano para o seu serviço (string, opcional). Valores aceitos:
      • starter
      • standard
      • pro
      • pro_max
      • pro_plus
      • pro_ultra
    • autoDeploy: Se deve fazer deploy automático do serviço (string, opcional). O padrão é yes. Valores aceitos:
      • yes: Ativar deployments automáticos
      • no: Desativar deployments automáticos
    • region: Região geográfica para deployment (string, opcional). O padrão é oregon. Valores aceitos:
      • oregon
      • frankfurt
      • singapore
      • ohio
      • virginia
    • envVars: Array de variáveis de ambiente (array, opcional)

  • create_static_site - Cria um novo site estático na sua conta do Render

    • name: Um nome exclusivo para o seu serviço (string, obrigatório)
    • buildCommand: Comando para compilar seu aplicativo (string, obrigatório)
    • repo: Repositório contendo o código-fonte (string, opcional)
    • branch: Ramo do repositório para fazer deploy (string, opcional)
    • autoDeploy: Se deve fazer deploy automático do serviço (string, opcional). O padrão é yes. Valores aceitos:
      • yes: Ativar deployments automáticos
      • no: Desativar deployments automáticos
    • publishPath: Diretório contendo os assets compilados (string, opcional)
    • envVars: Array de variáveis de ambiente (array, opcional)

  • create_cron_job - Cria um novo cron job na sua conta do Render

    • name: Um nome exclusivo para o seu cron job (string, obrigatório)
    • schedule: Expressão de agendamento cron (string, obrigatório). Usa sintaxe cron padrão com 5 campos: minuto (0-59), hora (0-23), dia do mês (1-31), mês (1-12), dia da semana (0-6, Domingo=0). Exemplos:
      • 0 0 * * *: Diariamente à meia-noite
      • */15 * * * *: A cada 15 minutos
      • 0 9 * * 1-5: Dias úteis às 9h
      • 0 0 1 * *: Primeiro dia de cada mês à meia-noite
    • runtime: Ambiente de execução para o seu cron job (string, obrigatório). Valores aceitos:
      • node
      • python
      • go
      • rust
      • ruby
      • elixir
      • docker
    • buildCommand: Comando usado para compilar seu cron job (string, obrigatório)
    • startCommand: Comando que é executado quando seu cron job é acionado (string, obrigatório)
    • repo: Repositório contendo o código-fonte (string, opcional)
    • branch: Ramo do repositório para fazer deploy (string, opcional)
    • plan: Plano para o seu cron job (string, opcional). Valores aceitos:
      • starter
      • standard
      • pro
      • pro_max
      • pro_plus
      • pro_ultra
    • autoDeploy: Se deve fazer deploy automático do cron job (string, opcional). O padrão é yes. Valores aceitos:
      • yes: Ativar deployments automáticos
      • no: Desativar deployments automáticos
    • region: Região geográfica para deployment (string, opcional). O padrão é oregon. Valores aceitos:
      • oregon
      • frankfurt
      • singapore
      • ohio
      • virginia
    • envVars: Array de variáveis de ambiente (array, opcional)

  • update_environment_variables - Atualiza todas as variáveis de ambiente de um serviço

    • serviceId: O ID do serviço a ser atualizado (string, obrigatório)
    • envVars: Lista completa de variáveis de ambiente (array, obrigatório)

  • update_web_service - Atualizações diretas em um web service não são suportadas pelo servidor MCP. Esta ferramenta retorna um link para as configurações do serviço no Render Dashboard, onde as alterações podem ser feitas (ou via Render API).

    • serviceId: O ID do serviço a ser atualizado (string, obrigatório)

  • update_static_site - Atualizações diretas em um site estático não são suportadas pelo servidor MCP. Esta ferramenta retorna um link para as configurações do site no Render Dashboard, onde as alterações podem ser feitas (ou via Render API).

    • serviceId: O ID do serviço a ser atualizado (string, obrigatório)

  • update_cron_job - Atualizações diretas em um cron job não são suportadas pelo servidor MCP. Esta ferramenta retorna um link para as configurações do cron job no Render Dashboard, onde as alterações podem ser feitas (ou via Render API).

    • serviceId: O ID do serviço a ser atualizado (string, obrigatório)

Deployments

  • list_deploys - Lista o histórico de deployments de um serviço

    • serviceId: O ID do serviço para obter os deployments (string, obrigatório)

  • get_deploy - Obtém detalhes sobre um deployment específico

    • serviceId: O ID do serviço (string, obrigatório)
    • deployId: O ID do deployment (string, obrigatório)

  • trigger_deploy - Aciona um novo deploy para um serviço. Serviços com autoDeploy habilitado fazem deploy automaticamente ao receber push; use esta ferramenta para deploys que não ocorrem automaticamente.

    • serviceId: O ID do serviço para fazer deploy (string, obrigatório)
    • clearCache: Se deve limpar o cache de build antes do deploy (boolean, opcional). O padrão é false.

Logs

  • list_logs - Lista logs que correspondem aos filtros fornecidos

    • resource: Filtrar logs por recurso (array de strings, obrigatório)
    • level: Filtrar logs por nível de gravidade (array de strings, opcional)
    • type: Filtrar logs por tipo (array de strings, opcional)
    • instance: Filtrar logs pela instância de onde foram emitidos (array de strings, opcional)
    • host: Filtrar logs de requisição por host (array de strings, opcional)
    • statusCode: Filtrar logs de requisição por código de status (array de strings, opcional)
    • method: Filtrar logs de requisição por método da requisição (array de strings, opcional)
    • path: Filtrar logs de requisição por caminho (array de strings, opcional)
    • text: Filtrar pelo texto dos logs (array de strings, opcional)
    • startTime: Horário de início para consulta de logs (formato RFC3339) (string, opcional)
    • endTime: Horário de término para consulta de logs (formato RFC3339) (string, opcional)
    • direction: A direção para consultar logs (string, opcional)
    • limit: Número máximo de logs a retornar (number, opcional)

  • list_log_label_values - Lista todos os valores para um determinado rótulo de log nos logs que correspondem aos filtros fornecidos

    • label: O rótulo para listar valores (string, obrigatório)
    • resource: Filtrar por recurso (array de strings, obrigatório)
    • level: Filtrar logs por nível de gravidade (array de strings, opcional)
    • type: Filtrar logs por tipo (array de strings, opcional)
    • instance: Filtrar logs pela instância de onde foram emitidos (array de strings, opcional)
    • host: Filtrar logs de requisição por host (array de strings, opcional)
    • statusCode: Filtrar logs de requisição por código de status (array de strings, opcional)
    • method: Filtrar logs de requisição por método da requisição (array de strings, opcional)
    • path: Filtrar logs de requisição por caminho (array de strings, opcional)
    • text: Filtrar pelo texto dos logs (array de strings, opcional)
    • startTime: Horário de início para consulta de logs (formato RFC3339) (string, opcional)
    • endTime: Horário de término para consulta de logs (formato RFC3339) (string, opcional)
    • direction: A direção para consultar logs (string, opcional)

Métricas

  • get_metrics - Obtém métricas de desempenho para qualquer recurso do Render (serviços, bancos de dados Postgres, armazenamentos de chave-valor). As métricas podem estar vazias se a métrica não for válida para o recurso fornecido.
    • resourceId: O ID do recurso para obter métricas (ID do serviço, ID do Postgres ou ID do armazenamento de chave-valor) (string, obrigatório)
    • metricTypes: Quais métricas buscar (array de strings, obrigatório). Valores aceitos:
      • cpu_usage: Métricas de uso de CPU (disponíveis para todos os recursos)
      • cpu_limit: Restrições de recursos de CPU (disponíveis para todos os recursos)
      • cpu_target: Limiares de autoescalonamento de CPU (disponíveis para todos os recursos)
      • memory_usage: Métricas de uso de memória (disponíveis para todos os recursos)
      • memory_limit: Restrições de recursos de memória (disponíveis para todos os recursos)
      • memory_target: Limiares de autoescalonamento de memória (disponíveis para todos os recursos)
      • instance_count: Métricas de contagem de instâncias (disponíveis para todos os recursos)
      • http_request_count: Métricas de contagem de solicitações HTTP (somente serviços)
      • http_latency: Métricas de tempo de resposta HTTP (somente serviços)
      • bandwidth_usage: Métricas de uso de largura de banda (somente serviços)
      • active_connections: Métricas de conexões ativas (somente bancos de dados e armazenamentos de chave-valor)
    • startTime: Horário de início para consulta de métricas no formato RFC3339 (ex.: '2024-01-01T12:00:00Z'), padrão é 1 hora atrás. O horário de início deve estar dentro dos últimos 30 dias (string, opcional)
    • endTime: Horário de término para consulta de métricas no formato RFC3339 (ex.: '2024-01-01T13:00:00Z'), padrão é o horário atual. O horário de término deve estar dentro dos últimos 30 dias (string, opcional)
    • resolution: Resolução de tempo para pontos de dados em segundos. Valores menores fornecem dados mais granulares. Valores maiores fornecem pontos de dados mais agregados. A API usa 60 segundos se não for fornecido, mínimo 30 segundos (número, opcional)
    • cpuUsageAggregationMethod: Método para agregar valores de métrica de uso de CPU ao longo de intervalos de tempo (string, opcional). O padrão é AVG. Valores aceitos:
      • AVG: Uso médio de CPU ao longo de intervalos de tempo
      • MAX: Uso máximo de CPU ao longo de intervalos de tempo
      • MIN: Uso mínimo de CPU ao longo de intervalos de tempo
    • aggregateHttpRequestCountsBy: Campo para agregar métricas de contagem de solicitações HTTP (string, opcional). Quando não especificado, retorna contagens totais de solicitações. Valores aceitos:
      • host: Agregar por host da solicitação
      • statusCode: Agregar por código de status HTTP
    • httpLatencyQuantile: O quantil/percentil de latência HTTP a ser buscado. Suportado apenas para a métrica http_latency. Valores comuns: 0.5 (mediana), 0.95 (95º percentil), 0.99 (99º percentil). O padrão é 0.95 se não especificado (número, opcional, min: 0.0, max: 1.0)
    • httpHost: Filtrar métricas HTTP para hosts de solicitação específicos. Suportado para as métricas http_request_count e http_latency. Exemplo: 'api.example.com' ou 'myapp.render.com'. Quando não especificado, inclui todos os hosts (string, opcional)
    • httpPath: Filtrar métricas HTTP para caminhos de solicitação específicos. Suportado para as métricas http_request_count e http_latency. Exemplo: '/api/users' ou '/health'. Quando não especificado, inclui todos os caminhos (string, opcional)

Bancos de dados Postgres

  • query_render_postgres - Executa uma consulta SQL somente leitura em um banco de dados Postgres hospedado no Render

    • postgresId: O ID da instância Postgres para consultar (string, obrigatório)
    • sql: A consulta SQL a ser executada (string, obrigatório)

  • list_postgres_instances - Lista todos os bancos de dados PostgreSQL na sua conta do Render

    • Nenhum parâmetro necessário

  • get_postgres - Obtém detalhes sobre um banco de dados PostgreSQL específico

    • postgresId: O ID do banco de dados PostgreSQL para recuperar (string, obrigatório)

  • create_postgres - Cria um novo banco de dados PostgreSQL

    • name: Nome do banco de dados PostgreSQL (string, obrigatório)
    • plan: Plano de preços para o banco de dados (string, obrigatório). Valores aceitos:
      • free
      • basic_256mb
      • basic_1gb
      • basic_4gb
      • pro_4gb
      • pro_8gb
      • pro_16gb
      • pro_32gb
      • pro_64gb
      • pro_128gb
      • pro_192gb
      • pro_256gb
      • pro_384gb
      • pro_512gb
      • accelerated_16gb
      • accelerated_32gb
      • accelerated_64gb
      • accelerated_128gb
      • accelerated_256gb
      • accelerated_384gb
      • accelerated_512gb
      • accelerated_768gb
      • accelerated_1024gb
    • region: Região para implantação (string, opcional). Valores aceitos:
      • oregon
      • frankfurt
      • singapore
      • ohio
      • virginia
    • version: Versão do PostgreSQL a ser usada (ex.: 14, 15) (número, opcional)
    • diskSizeGb: Capacidade do banco de dados em GB (número, opcional)

Instâncias de Key Value

  • list_key_value - Lista todas as instâncias de Key Value na sua conta do Render

    • Nenhum parâmetro necessário

  • get_key_value - Obtém detalhes sobre uma instância de Key Value específica

    • keyValueId: O ID da instância de Key Value para recuperar (string, obrigatório)

  • create_key_value - Cria uma nova instância de Key Value

    • name: Nome da instância de Key Value (string, obrigatório)
    • plan: Plano de preços para a instância de Key Value (string, obrigatório). Valores aceitos:
      • free
      • starter
      • standard
      • pro
      • pro_plus
    • region: Região para implantação (string, opcional). Valores aceitos:
      • oregon
      • frankfurt
      • singapore
      • ohio
      • virginia
    • maxmemoryPolicy: Política de expulsão (eviction) para o armazenamento de chave-valor (string, opcional). Valores aceitos:
      • noeviction: Sem política de expulsão (pode causar erros de memória)
      • allkeys_lfu: Excluir as chaves menos frequentemente usadas de todas as chaves
      • allkeys_lru: Excluir as chaves menos recentemente usadas de todas as chaves
      • allkeys_random: Excluir chaves aleatórias de todas as chaves
      • volatile_lfu: Excluir as chaves menos frequentemente usadas entre chaves com expiração
      • volatile_lru: Excluir as chaves menos recentemente usadas entre chaves com expiração
      • volatile_random: Excluir chaves aleatórias entre chaves com expiração
      • volatile_ttl: Excluir chaves com menor tempo de vida restante entre chaves com expiração
    • persistenceMode: Comportamento de persistência de dados para o armazenamento de chave-valor (string, opcional). Valores aceitos:
      • journal_snapshot: Anexar todas as gravações a um diário e periodicamente salvar um snapshot em disco
      • snapshot: Salvar periodicamente um snapshot em disco
      • off: Desativar a persistência completamente para priorizar o desempenho de gravação