AppSignal MCP

AppSignal MCP

Um servidor Model Context Protocol (MCP) para integração com a API de monitoramento da AppSignal. Este servidor permite que assistentes de IA consultem e recuperem diretamente dados de erros e desempenho da AppSignal por meio do protocolo MCP.

Recursos

• Obter detalhes sobre amostras específicas de erros ou desempenho
• Pesquisar erros, amostras de desempenho ou ambos com filtros flexíveis
• Integração com as APIs de Monitoramento de Erros e Desempenho da AppSignal

Pré-requisitos

• Runtime Bun
• Conta AppSignal e token de API
• ID do aplicativo no painel da AppSignal

Instalação

# Clone the repository
git clone https://github.com/pauldub/appsignal-mcp.git
cd appsignal-mcp

# Install dependencies
bun install

Configuração

Crie um arquivo .env no diretório raiz com suas credenciais da AppSignal:

# Server configuration
PORT=3000
LOG_LEVEL=info

# AppSignal configuration
APPSIGNAL_API_TOKEN=your-api-token

Uso

Iniciando o Servidor

# Run the server
bun start

# Development mode with auto-reload
bun dev

# Run tests
bun test

# Build a standalone executable
bun run build

Opções de Linha de Comando

appsignal-mcp --appsignal-api-token your-token

Opções disponíveis:

• --appsignal-api-token <token> - Token da API AppSignal
• --log-level <level> - Nível de registro (debug, info, warn, error)
• --port <port> - Número da porta do servidor

Ferramentas MCP

1. get_sample

Obtém detalhes sobre uma amostra específica por ID (erro ou desempenho).

Parâmetros:

• sampleId (string, obrigatório): O ID da amostra AppSignal
• appId (string, obrigatório): O ID do aplicativo AppSignal

2. search_samples

Pesquisa amostras em um aplicativo com filtros opcionais.

Parâmetros:

• appId (string, obrigatório): O ID do aplicativo AppSignal
• sample_type (string, opcional): Tipo de amostras a pesquisar - "all", "errors" ou "performance" (padrão: "errors")
• exception (string, opcional): Filtrar por nome da exceção (ex.: "NoMethodError") - aplicável apenas para amostras de erro
• action_id (string, opcional): Filtrar por nome da ação (ex.: "BlogPostsController-hash-show")
• since (string/número, opcional): Timestamp de início em UTC (formato timestamp ou ISO)
• before (string/número, opcional): Timestamp de fim em UTC (formato timestamp ou ISO)
• limit (número, opcional): Número máximo de amostras a retornar (padrão: 10)
• count_only (booleano, opcional): Retornar apenas a contagem, não as amostras

Integração com Claude

Para usar este servidor MCP com Claude, crie um arquivo .mcp.json no seu espaço de trabalho do Claude Code:

{
  "mcpServers": {
    "appsignal-mcp": {
      "type": "stdio",
      "command": "bun",
      "args": [
        "run",
        "start"
      ],
      "env": {
        "APPSIGNAL_API_TOKEN": "your-api-token"
      }
    }
  }
}

Licença

MIT