Notas de la versión del servidor

Un servidor MCP que genera atractivas notas de lanzamiento desde repositorios de GitHub. Obtiene las confirmaciones de forma eficiente, las organiza por tipo y las presenta en un formato claro y legible.

Características

• 🎯 Filtrado de confirmación inteligente por fecha o SHA

• 📊 Agrupa las confirmaciones por tipo (características, correcciones, etc.)

• 🔍 Enriquece los compromisos con datos de relaciones públicas

• 📈 Incluye estadísticas detalladas

• 🎨 Formato de Markdown limpio con emojis

• ⚡ Uso eficiente de la API con el parámetro since de GitHub

Related MCP server: GitHub Releases MCP Server

Instalación

npm install
npm run build

Uso

Agregue este servidor a su configuración de MCP:

{
  "mcpServers": {
    "release-notes": {
      "command": "node",
      "args": ["/path/to/release-notes-server/build/index.js"],
      "env": {
        "GITHUB_TOKEN": "your-github-token"
      }
    }
  }
}

Herramientas disponibles

generar_notas_de_lanzamiento

Genera notas de lanzamiento para un repositorio de GitHub.

Parámetros:

{
  "owner": string,           // Repository owner
  "repo": string,           // Repository name
  "commitRange": {
    "fromCommit"?: string,  // Starting commit SHA
    "toCommit"?: string    // Ending commit SHA
  },
  "format": {
    "type": "markdown",     // Output format
    "groupBy": "type",      // How to group commits
    "includeStats": boolean // Include commit statistics
  }
}

Ejemplo:

const result = await use_mcp_tool({
  server_name: "release-notes",
  tool_name: "generate_release_notes",
  arguments: {
    owner: "owner",
    repo: "repo",
    commitRange: {
      fromCommit: "abc123" // Get commits from this SHA
    },
    format: {
      type: "markdown",
      groupBy: "type",
      includeStats: true
    }
  }
});

Formato de salida

Las notas de la versión generadas incluyen:

1. Encabezado con fecha de generación y estadísticas

2. Secciones agrupadas por tipo de confirmación:

   • 🚀 Características

   • 🐛 Correcciones

   • 📚 Documentación

   • ⚡ Rendimiento

   • ♻️ Refactorización

   • 🧪 Pruebas

   • 🏗️ Construir

   • 🔧 Otros

3. Estadísticas detalladas que incluyen:

   • Total de confirmaciones

   • Cambios importantes

   • Confirmaciones por tipo

   • Confirmaciones por autor

Variables de entorno

• GITHUB_TOKEN : Token de acceso personal de GitHub con acceso al repositorio

Detalles de implementación

El servidor implementa una obtención de confirmaciones eficiente mediante:

1. Usar el parámetro since de GitHub cuando sea posible para reducir las llamadas a la API

2. Recurrir al filtrado basado en SHA cuando sea necesario

3. Manejo adecuado de la paginación

4. Mantener el orden de los más nuevos primero para las notas de la versión

5. Enriquecer confirmaciones con datos de relaciones públicas cuando estén disponibles

Licencia

Instituto Tecnológico de Massachusetts (MIT)