Servidor MCP Rollbar

Una implementación de servidor MCP dinámica para la integración de API de Rollbar, que permite a los LLM interactuar con los datos de seguimiento de errores de Rollbar.

Características

Listar y filtrar elementos de error
Obtenga información detallada sobre errores
Ver ocurrencias de errores
Acceda a los detalles del proyecto y del entorno
Seguimiento de despliegues
Lista de usuarios y equipos

Configuración

Variables de entorno

ROLLBAR_PROJECT_TOKEN : Token de acceso al proyecto Rollbar: necesario para que las API recuperen información sobre errores e implementación del proyecto
ROLLBAR_ACCOUNT_TOKEN : Token de acceso a la cuenta de Rollbar: necesario para que las API accedan a la información del proyecto y del usuario de toda la cuenta
ROLLBAR_PROJECT_ID : ID de proyecto predeterminado (se utiliza cuando no se especifica en las solicitudes) - Opcional
ROLLBAR_PROJECT_NAME : Nombre de proyecto predeterminado para referencia - Opcional

Nota : Dependiendo de las funciones que utilice, necesitará ROLLBAR_PROJECT_TOKEN , ROLLBAR_ACCOUNT_TOKEN o ambos. Para una funcionalidad completa, se recomienda configurar ambos tokens, pero el servicio solo funcionará con el token correspondiente para las API específicas.

Tokens requeridos y tabla de correspondencia de API

API	Token requerido
`rollbar_list_items`	TOKEN DEL PROYECTO ROLLBAR
`rollbar_get_item`	TOKEN DEL PROYECTO ROLLBAR
`rollbar_get_item_by_counter`	TOKEN DEL PROYECTO ROLLBAR
`rollbar_list_occurrences`	TOKEN DEL PROYECTO ROLLBAR
`rollbar_get_occurrence`	TOKEN DEL PROYECTO ROLLBAR
`rollbar_list_environments`	TOKEN DEL PROYECTO ROLLBAR
`rollbar_list_deploys`	TOKEN DEL PROYECTO ROLLBAR
`rollbar_get_deploy`	TOKEN DEL PROYECTO ROLLBAR
`rollbar_list_projects`	TOKEN DE CUENTA ROLLBAR
`rollbar_get_project`	TOKEN DE CUENTA ROLLBAR
`rollbar_list_users`	TOKEN DE CUENTA ROLLBAR
`rollbar_get_user`	TOKEN DE CUENTA ROLLBAR

Puede obtener tokens de acceso a Rollbar de la siguiente manera:

Inicie sesión en su cuenta de Rollbar ( https://rollbar.com/ )
Para tokens de proyecto: Configuración -> Tokens de acceso al proyecto (para acceso a nivel de proyecto)
Para tokens de cuenta: Configuración -> Tokens de acceso a la cuenta (para acceso a nivel de cuenta)
Crear un nuevo token con alcance de "lectura"

Cómo utilizar

Integración del cursor

Añade a tu ~/.cursor/mcp.json :

{
    "mcpServers": {
      "rollbar-mcp": {
        "command": "npx",
        "args": ["-y", "@hiyorineko/mcp-rollbar-server"],
        "env": {
          "ROLLBAR_PROJECT_TOKEN": "YOUR_PROJECT_ACCESS_TOKEN",
          "ROLLBAR_ACCOUNT_TOKEN": "YOUR_ACCOUNT_ACCESS_TOKEN",
          "ROLLBAR_PROJECT_ID": "YOUR_PROJECT_ID",
          "ROLLBAR_PROJECT_NAME": "YOUR_PROJECT_NAME"
        }
      }
    }
}

En la zona

Después de clonar este repositorio, siga estos pasos para configurar el cliente MCP:

$ cd mcp-rollbar-server
$ npm install
$ npm run build

Añade a tu ~/.cursor/mcp.json :

{
    "mcpServers": {
      "rollbar-mcp": {
        "command": "YOUR_NODE_PATH",
        "args": ["YOUR_PROJECT_PATH/mcp-rollbar-server/dist/src/index.js"],
        "env": {
          "ROLLBAR_PROJECT_TOKEN": "YOUR_PROJECT_ACCESS_TOKEN",
          "ROLLBAR_ACCOUNT_TOKEN": "YOUR_ACCOUNT_ACCESS_TOKEN",
          "ROLLBAR_PROJECT_ID": "YOUR_PROJECT_ID",
          "ROLLBAR_PROJECT_NAME": "YOUR_PROJECT_NAME"
        }
      }
    }
}

Para encontrar el valor de "YOUR_NODE_PATH", ejecute which node en su terminal.

Ejemplos de uso

List the most recent errors in my production environment.

Ver detalles del error

Get detailed information for error item with ID 12345, including stack trace and recent occurrences.

Despliegues de pistas

Show me the recent deployments for project 67890.

Filtrar errores por nivel

List all critical errors that occurred in the last week.

Herramientas

elementos de la lista de la barra de rollo

Lista de elementos (errores) de Rollbar

Aporte:
- status (cadena, opcional): filtrar por estado (activo, resuelto, silenciado, etc.)
- level (cadena, opcional): filtrar por nivel (crítico, error, advertencia, información, depuración)
- environment (cadena, opcional): filtrar por entorno (producción, ensayo, etc.)
- limit (número, opcional): Número máximo de artículos a devolver (predeterminado: 20)
- page (número, opcional): Número de página para paginación (predeterminado: 1)
Devuelve: Lista de elementos de error con detalles como contador, nivel, total de ocurrencias, etc.

rollbar_get_item

Obtenga un artículo específico (error) de Rollbar utilizando la identificación de artículo interna mantenida por el sistema de Rollbar.

Aporte:
- id (número): ID del artículo
Devuelve: Información detallada sobre un elemento de error específico

rollbar_obtener_elemento_por_contador

Obtén un elemento específico por contador de proyecto de Rollbar. El contador es el ID visible que aparece en la interfaz de Rollbar.

Aporte:
- counter (número): contador de proyecto para el artículo
Devuelve: Información detallada sobre un elemento de error específico identificado por su contador de proyecto

rollbar_list_ocurrencias

Lista de ocurrencias de errores de Rollbar

Aporte:
- itemId (número, opcional): ID del artículo para filtrar las incidencias
- limit (número, opcional): número máximo de ocurrencias a devolver (predeterminado: 20)
- page (número, opcional): Número de página para paginación (predeterminado: 1)
Devuelve: Lista de ocurrencias de errores con información detallada

rollbar_get_ocurrence

Obtener una ocurrencia específica de un error de Rollbar

Aporte:
- id (cadena): ID de ocurrencia
Devuelve: Información detallada sobre una ocurrencia de error específica

rollbar_list_proyectos

Lista de proyectos de Rollbar

Entrada: Ninguna
Devuelve: Lista de proyectos con sus ID, nombres y estados

rollbar_get_project

Obtenga un proyecto específico de Rollbar

Aporte:
- id (número): ID del proyecto
Devoluciones: Información detallada sobre un proyecto específico

rollbar_list_environments

Lista de entornos de Rollbar

Aporte:
- projectId (número): ID del proyecto
Devuelve: Lista de entornos para el proyecto especificado

lista_de_usuarios_de_rollbar

Lista de usuarios de Rollbar

Entrada: Ninguna
Devuelve: Lista de usuarios con sus ID, nombres de usuario, correos electrónicos y niveles de acceso

rollbar_get_user

Obtener un usuario específico de Rollbar

Aporte:
- id (número): ID de usuario
Devuelve: Información detallada sobre un usuario específico

rollbar_list_deploys

Lista de implementaciones desde Rollbar

Aporte:
- projectId (número): ID del proyecto
- environment (cadena, opcional): nombre del entorno
- limit (número, opcional): número máximo de implementaciones a devolver (predeterminado: 20)
- page (número, opcional): Número de página para paginación (predeterminado: 1)
Devuelve: Lista de implementaciones para el proyecto y entorno especificados

rollbar_get_deploy

Obtenga una implementación específica de Rollbar

Aporte:
- deployId (número): ID de implementación
Devuelve: Información detallada sobre una implementación específica