Uptime Agent

Conecta seu sistema de monitoramento do Uptime Agent a assistentes de IA.

Documentação

🚀 Servidor MCP do Uptime Agent

Conecte seu sistema de monitoramento Uptime Agent diretamente a assistentes de IA como o Claude por meio do Model Context Protocol (MCP).

✨ Recursos

Acesso a Monitoramento em Tempo Real: Permita que assistentes de IA verifiquem o status de disponibilidade do seu sistema
Gerenciamento de Incidentes: Visualize e analise incidentes de indisponibilidade por meio de conversas naturais
Criação de Monitores: Configure novos endpoints de monitoramento com comandos simples de voz ou texto
Integração Segura: Segurança de nível empresarial para sua infraestrutura de monitoramento

🔍 O que é o Uptime Agent?

O Uptime Agent é uma solução de monitoramento poderosa que rastreia seus sites e endpoints de API, alertando você quando eles ficam fora do ar. Este servidor MCP amplia os recursos do Uptime Agent permitindo que você interaja com seu sistema de monitoramento por meio de assistentes de IA.

🛠️ Instalação

Pré-requisitos

Node.js 18 ou superior
Uma conta ativa no Uptime Agent
Sua chave de API do Uptime Agent

Para obter sua chave de API do Uptime Agent:

Faça login no seu Painel do Uptime Agent
Navegue até Conta → Chaves de API
Crie uma nova chave de API com as permissões adequadas
Copie a chave gerada para usar com o servidor MCP

Opção 1: Instalação Rápida via NPM (Recomendada)

A maneira mais rápida de começar é com nosso comando de configuração:

npx uptime-agent-mcp setup

Este comando irá:

Instalar o servidor MCP
Configurá-lo para uso com o Claude Desktop
Solicitar sua chave de API do Uptime Agent
Configurar todas as configurações necessárias automaticamente

Opção 2: Instalação via Smithery.ai

Para instalar usando o Smithery.ai:

Crie uma conta em smithery.ai
Obtenha sua chave pessoal na sua conta Smithery
Execute o seguinte comando:

npx -y @smithery/cli@latest install @AVIMBU/uptime_agent_mcp --client claude --key <personal_key>

Substitua <personal_key> pela sua chave pessoal real do Smithery.

Opção 3: Instalação Manual Local

Para usuários avançados que desejam mais controle:

# Clone the repository
git clone https://github.com/AVIMBU/uptime_agent_mcp.git
cd uptime_agent_mcp

# Install dependencies
npm install

# Build the project
npm run build

Configure com sua chave de API criando um arquivo .env:

UPTIME_API_KEY=your-api-key-here
PORT=3000  # Optional, defaults to 3000

Inicie o servidor:

npm start
# or directly with
node dist/index.js

🤖 Integração com Assistente de IA

Configuração com o Claude Desktop

Após instalar usando um dos métodos acima, seu servidor MCP é configurado automaticamente para o Claude Desktop.

Se você instalou manualmente, adicione o seguinte ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "uptime-agent": {
      "command": "npx",
      "args": [
        "-y",
        "uptime-agent-mcp"
      ],
      "env": {
        "UPTIME_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Alternativamente, você pode usar Docker:

{
  "mcpServers": {
    "uptime-agent": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "UPTIME_API_KEY",
        "uptime-agent-mcp"
      ],
      "env": {
        "UPTIME_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Exemplos de Conversas

Verificando Monitores:

"Claude, mostre-me todos os meus monitores de disponibilidade ativos."

Criando um Novo Monitor:

"Por favor, crie um novo monitor para nosso endpoint de API em https://api.mycompany.com/v2/health"

Analisando Incidentes:

"Quais incidentes aconteceram em nossos servidores de produção na semana passada e qual foi o tempo médio de indisponibilidade?"

📊 Funções Disponíveis

Operações de Monitor

Função	Descrição	Parâmetros
`listMonitors`	Obter uma lista completa de todos os endpoints de monitoramento	Nenhum necessário
`getMonitor`	Recuperar informações detalhadas sobre um monitor específico	`id`: Identificador do monitor
`createMonitor`	Configurar um novo endpoint para monitorar	`name`: Nome do monitor `url`: URL a ser monitorada `tracking_type`: Tipo de monitoramento (http, ping, etc.) `check_frequency`: Intervalo de verificação em segundos

Gerenciamento de Incidentes

Função	Descrição	Parâmetros
`listIncidents`	Visualizar todos os incidentes de indisponibilidade detectados	Nenhum necessário
`getIncident`	Obter informações detalhadas sobre um incidente específico	`id`: Identificador do incidente
`listIncidentsByMonitor`	Ver todos os incidentes de um endpoint específico	`monitor_id`: Identificador do monitor

Rastreamento Público

Função	Descrição	Parâmetros
`createAnonymousTracking`	Criar rastreamento público sem autenticação	`url`: URL a ser monitorada `name`: (Opcional) Nome para o rastreamento

Integração com Slack (Em Breve)

Função	Descrição	Parâmetros
`slack_get_users`	Listar todos os usuários no workspace do Slack conectado	`limit`: Número máximo de usuários `cursor`: Cursor de paginação
`slack_post_message`	Publicar notificações no Slack	`channel_id`: Canal para publicar `text`: Conteúdo da mensagem

🐳 Implantação com Docker

Oferecemos suporte a Docker para implantação fácil:

# Build the Docker image
docker build -t uptime-agent-mcp .

# Run the container
docker run -p 3000:3000 -e UPTIME_API_KEY=your-api-key uptime-agent-mcp

📬 Suporte

Se você tiver dúvidas ou precisar de assistência:

Abra uma issue no GitHub
Entre em contato conosco pelo nosso site: AVIMBU

📜 Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.

Desenvolvido com ❤️ por AVIMBU