AppSignal MCP

AppSignal MCP

Un servidor de Model Context Protocol (MCP) para la integración con la API de monitoreo de AppSignal. Este servidor permite a los asistentes de IA consultar y obtener directamente datos de errores y rendimiento de AppSignal a través del protocolo MCP.

Características

• Obtener detalles sobre muestras específicas de errores o rendimiento
• Buscar errores, muestras de rendimiento o ambos con filtros flexibles
• Integración con las APIs de monitoreo de errores y rendimiento de AppSignal

Requisitos previos

• Bun runtime
• Cuenta de AppSignal y token de API
• ID de aplicación desde tu panel de AppSignal

Instalación

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

# Install dependencies
bun install

Configuración

Crea un archivo .env en el directorio raíz con tus credenciales de AppSignal:

# Server configuration
PORT=3000
LOG_LEVEL=info

# AppSignal configuration
APPSIGNAL_API_TOKEN=your-api-token

Uso

Iniciar el servidor

# Run the server
bun start

# Development mode with auto-reload
bun dev

# Run tests
bun test

# Build a standalone executable
bun run build

Opciones de línea de comandos

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

Opciones disponibles:

• --appsignal-api-token <token> - Token de API de AppSignal
• --log-level <level> - Nivel de registro (debug, info, warn, error)
• --port <port> - Número de puerto del servidor

Herramientas MCP

1. get_sample

Obtiene detalles sobre una muestra específica por ID (error o rendimiento).

Parámetros:

• sampleId (cadena, obligatorio): El ID de muestra de AppSignal
• appId (cadena, obligatorio): El ID de aplicación de AppSignal

2. search_samples

Busca muestras en una aplicación con filtros opcionales.

Parámetros:

• appId (cadena, obligatorio): El ID de aplicación de AppSignal
• sample_type (cadena, opcional): Tipo de muestras a buscar - "all", "errors" o "performance" (por defecto "errors")
• exception (cadena, opcional): Filtrar por nombre de excepción (ej., "NoMethodError") - solo aplicable para muestras de error
• action_id (cadena, opcional): Filtrar por nombre de acción (ej., "BlogPostsController-hash-show")
• since (cadena/número, opcional): Marca de tiempo de inicio en UTC (formato de marca de tiempo o ISO)
• before (cadena/número, opcional): Marca de tiempo de fin en UTC (formato de marca de tiempo o ISO)
• limit (número, opcional): Número máximo de muestras a devolver (por defecto 10)
• count_only (booleano, opcional): Devolver solo el recuento, no las muestras

Integración con Claude

Para usar este servidor MCP con Claude, crea un archivo .mcp.json en tu espacio de trabajo de Claude Code:

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

Licencia

MIT