AWS Application Signals

Servidor MCP para AWS Application Signals

Um servidor MCP (Model Context Protocol) que fornece ferramentas para monitorar, analisar e solucionar problemas dos serviços AWS Application Signals.

Este servidor permite que assistentes de IA interajam com AWS Application Signals para acompanhar a saúde dos serviços, monitorar SLOs (Service Level Objectives), analisar métricas e investigar problemas usando rastreamento distribuído.

Ferramentas Disponíveis

Este servidor fornece as seguintes ferramentas para interagir com AWS Application Signals:

• list_monitored_services - Lista todos os serviços monitorados pelo AWS Application Signals

• get_service_detail - Obtém os dados de saúde detalhados de um serviço específico

• get_service_metrics - Consulta métricas do CloudWatch para os serviços monitorados

• list_slis - Monitora o status do SLI (Service Level Indicator) e a conformidade com SLOs em todos os serviços

• get_slo - Recupera a configuração detalhada de um SLO específico

• query_sampled_traces - Consulta rastreamentos do AWS X-Ray para análise de rastreamento distribuído

• search_transaction_spans - Consulta dados de rastreamentos do AWS X-Ray

Configuração Rápida

Pré-requisitos

• Credenciais AWS configuradas (via aws configure ou variáveis de ambiente)
• Aplicativo Claude Desktop instalado
• Gerenciador de pacotes uv instalado (guia de instalação)
  • Observação: uvx está incluído na instalação do uv

Instalação

Você pode instalar este servidor MCP no Claude Desktop usando um dos seguintes métodos:

Método 1: Direto do GitHub (Recomendado)

Adicione esta configuração às configurações do seu Claude Desktop:

{
  "mcpServers": {
    "appsignals": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/mxiamxia/appsignals-mcp.git",
        "mcp-server-appsignals"
      ]
    }
  }
}

Método 2: Instalação Local

1. Clone este repositório
2. Instale as dependências (se necessário):

   uv pip install -e .
   

3. Adicione à configuração do Claude Desktop:

   {
     "mcpServers": {
       "appsignals": {
         "command": "uv",
         "args": [
           "--directory",
           "/path/to/appsignals-mcp",
           "run",
           "mcp-server-appsignals"
         ]
       }
     }
   }
   

Integração com Amazon Q

A integração com Amazon Q é semelhante à configuração do Claude Desktop. Primeiro, instale o Amazon Q Developer e você precisará apenas adicionar o seguinte ao seu arquivo ~/.aws/amazonq/mcp.json:

{
    "mcpServers": {
        "appsignals": {
            "command": "uvx",
            "args": [
                "--from",
                "git+https://github.com/mxiamxia/appsignals-mcp.git",
                "mcp-server-appsignals"
            ],
            "env": {
                "AWS_ACCESS_KEY_ID": "<aws_access_key>",
                "AWS_SECRET_ACCESS_KEY": "<aws_secret_access_key>"
            },
            "timeout": 60000
        }
    }
}

Desenvolvimento

uv pip install -e .