A continuación se presenta una versión revisada y pulida del archivo README.md para el proyecto mcp-sentry-custom , con el formato correcto para mayor claridad, precisión y profesionalidad. Se adhiere a las convenciones estándar de Markdown y organiza el contenido en secciones lógicas.

mcp-sentry-custom: Un servidor Sentry MCP

Descripción general

mcp-sentry-custom es un servidor de Protocolo de Contexto de Modelo (MCP) diseñado para recuperar y analizar problemas de Sentry.io o instancias de Sentry alojadas en el servidor. Este servidor proporciona herramientas para inspeccionar informes de errores, seguimientos de pila y otra información de depuración directamente desde su cuenta de Sentry.

Related MCP server: Sentry MCP Server

Características

Herramientas

1. get_sentry_issue

   • Descripción : Recupere y analice un problema específico de Sentry por su ID o URL.

   • Aporte :

     • issue_id_or_url (cadena): el ID del problema de Sentry o la URL completa para analizar.

   • Devoluciones : Información detallada del problema, que incluye:

     • Título

     • Identificación del problema

     • Estado

     • Nivel

     • Marca de tiempo de primera visualización

     • Marca de tiempo de la última vez que se vio

     • Recuento de eventos

     • Rastreo de pila completo

2. get_list_issues

   • Descripción : Recupere y analice una lista de problemas de Sentry para un proyecto específico.

   • Aporte :

     • project_slug (cadena): El slug del proyecto Sentry.

     • organization_slug (cadena): El slug de la organización Sentry.

   • Devoluciones : Una lista de problemas con detalles, incluidos:

     • Título

     • Identificación del problema

     • Estado

     • Nivel

     • Marca de tiempo de primera visualización

     • Marca de tiempo de la última vez que se vio

     • Recuento de eventos

     • Información básica del problema

Indicaciones

1. sentry-issue

   • Descripción : Recupere detalles de problemas formateados de Sentry para usarlos en el contexto de conversación.

   • Aporte :

     • issue_id_or_url (cadena): El ID o URL del problema de Sentry.

   • Devuelve : Detalles del problema formateados.

Instalación

Instalación mediante herrería

Para instalar mcp-sentry-custom para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @javaDer/mcp-sentry-custom --client claude

Uso de uv (recomendado)

Al usar uv , no se requiere una instalación específica. Puede ejecutar mcp-sentry-custom directamente con uvx :

uvx mcp-sentry-custom --auth-token YOUR_SENTRY_TOKEN --project-slug YOUR_PROJECT_SLUG --organization-slug YOUR_ORGANIZATION_SLUG --sentry-url YOUR_SENTRY_URL

Usando pip

Alternativamente, instale mcp-sentry-custom a través de pip :

pip install mcp-sentry-custom

O, con uv :

uv pip install -e .

Después de la instalación, ejecútelo como un script:

python -m mcp_sentry

Configuración

Uso con Claude Desktop

Agregue lo siguiente a su claude_desktop_config.json :

Uso de uvx

{
  "mcpServers": {
    "sentry": {
      "command": "uvx",
      "args": [
        "mcp-sentry-custom",
        "--auth-token", "YOUR_SENTRY_TOKEN",
        "--project-slug", "YOUR_PROJECT_SLUG",
        "--organization-slug", "YOUR_ORGANIZATION_SLUG",
        "--sentry-url", "YOUR_SENTRY_URL"
      ]
    }
  }
}

Usando Docker

{
  "mcpServers": {
    "sentry": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "mcp/sentry",
        "--auth-token", "YOUR_SENTRY_TOKEN",
        "--project-slug", "YOUR_PROJECT_SLUG",
        "--organization-slug", "YOUR_ORGANIZATION_SLUG",
        "--sentry-url", "YOUR_SENTRY_URL"
      ]
    }
  }
}

Uso de la instalación pip

{
  "mcpServers": {
    "sentry": {
      "command": "python",
      "args": [
        "-m", "mcp_sentry",
        "--auth-token", "YOUR_SENTRY_TOKEN",
        "--project-slug", "YOUR_PROJECT_SLUG",
        "--organization-slug", "YOUR_ORGANIZATION_SLUG",
        "--sentry-url", "YOUR_SENTRY_URL"
      ]
    }
  }
}

Uso con Zed

Agregue lo siguiente a su settings.json en Zed:

Uso de uvx

{
  "context_servers": {
    "mcp-sentry-custom": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-sentry-custom",
          "--auth-token", "YOUR_SENTRY_TOKEN",
          "--project-slug", "YOUR_PROJECT_SLUG",
          "--organization-slug", "YOUR_ORGANIZATION_SLUG",
          "--sentry-url", "YOUR_SENTRY_URL"
        ]
      }
    }
  }
}

Uso de la instalación pip

{
  "context_servers": {
    "mcp-sentry-custom": {
      "command": "python",
      "args": [
        "-m", "mcp_sentry",
        "--auth-token", "YOUR_SENTRY_TOKEN",
        "--project-slug", "YOUR_PROJECT_SLUG",
        "--organization-slug", "YOUR_ORGANIZATION_SLUG",
        "--sentry-url", "YOUR_SENTRY_URL"
      ]
    }
  }
}

Uso de la instalación pip con ruta personalizada

{
  "context_servers": {
    "mcp-sentry-custom": {
      "command": "python",
      "args": [
        "-m", "mcp_sentry",
        "--auth-token", "YOUR_SENTRY_TOKEN",
        "--project-slug", "YOUR_PROJECT_SLUG",
        "--organization-slug", "YOUR_ORGANIZATION_SLUG",
        "--sentry-url", "YOUR_SENTRY_URL"
      ],
      "env": {
        "PYTHONPATH": "path/to/mcp-sentry-custom/src"
      }
    }
  }
}

Depuración

Utilice el inspector MCP para depurar el servidor.

Para instalaciones uvx

npx @modelcontextprotocol/inspector uvx mcp-sentry-custom --auth-token YOUR_SENTRY_TOKEN --project-slug YOUR_PROJECT_SLUG --organization-slug YOUR_ORGANIZATION_SLUG --sentry-url YOUR_SENTRY_URL

Para el desarrollo local

Si ha instalado el paquete en un directorio específico o lo está desarrollando:

cd path/to/mcp-sentry-custom/src
npx @modelcontextprotocol/inspector uv run mcp-sentry-custom --auth-token YOUR_SENTRY_TOKEN --project-slug YOUR_PROJECT_SLUG --organization-slug YOUR_ORGANIZATION_SLUG --sentry-url YOUR_SENTRY_URL

O bien, con un directorio personalizado:

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-sentry-custom/src run mcp_sentry --auth-token YOUR_SENTRY_TOKEN --project-slug YOUR_PROJECT_SLUG --organization-slug YOUR_ORGANIZATION_SLUG --sentry-url YOUR_SENTRY_URL

Bifurcado de

Este proyecto se bifurcó de:
https://github.com/modelcontextprotocol/servers/tree/main/src/sentry

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT . Puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulte el archivo LICENSE en el repositorio del proyecto.

Notas sobre los cambios

1. Formato : Se utilizaron encabezados, listas y bloques de código Markdown adecuados para facilitar la lectura.

2. Coherencia : terminología estandarizada (por ejemplo, mcp_sentry vs. mcp-sentry-custom ) y etiquetas <TEXT> y <JSON> redundantes eliminadas.

3. Claridad : se reescribieron secciones como "Descripción general" y "Características" para lograr concisión y precisión.

4. Completitud : se corrigieron las oraciones incompletas y se aseguró que todos los ejemplos de configuración estuvieran estructurados correctamente.

5. Tono profesional : Se ajustó la redacción para que suene más formal y pulida.

¡Avísame si quieres mejoras adicionales!