Servidor MCP de notificaciones de GitHub

Un servidor MCP (Protocolo de Contexto de Modelo) que proporciona herramientas para gestionar las notificaciones de GitHub. Este servidor permite que asistentes de IA como Claude te ayuden a gestionar tus notificaciones de GitHub mediante comandos de lenguaje natural.

Características

• Enumera y filtra tus notificaciones de GitHub

• Marcar notificaciones como leídas

• Ver detalles del hilo de notificaciones

• Suscribirse o cancelar la suscripción a los hilos de notificaciones

• Marcar hilos como terminados

• Administrar notificaciones específicas del repositorio

• Controlar la configuración de notificaciones del repositorio (todas las actividades, predeterminadas o silenciadas)

Related MCP server: GitHub MCP Server

Prerrequisitos

• Node.js 18 o superior

• Token de acceso personal de GitHub (clásico) con notifications o alcance repo

Instalación

1. Clonar este repositorio

   git clone https://github.com/yourusername/github-notifications-mcp-server.git
   cd github-notifications-mcp-server

2. Instalar dependencias

   npm install

3. Construir el proyecto

   npm run build

4. Crea un archivo .env con tu token de GitHub

   GITHUB_TOKEN=your_github_personal_access_token_here

Uso

Ejecutar el servidor directamente

npm start

Uso con Claude Desktop

Agregue el servidor a su archivo claude_desktop_config.json :

{
  "mcpServers": {
    "github-notifications": {
      "command": "node",
      "args": ["/absolute/path/to/github-notifications-mcp-server/build/index.js"],
      "env": {
        "GITHUB_TOKEN": "your_github_personal_access_token_here"
      }
    }
  }
}

Herramientas disponibles

Ejemplos de indicaciones

A continuación se muestran algunos ejemplos de indicaciones que puede utilizar con Claude Desktop una vez que el servidor esté conectado:

• "¿Puedes revisar mis notificaciones de GitHub?"

• "Muéstrame mis notificaciones no leídas de las últimas 24 horas".

• "Marcar todas mis notificaciones como leídas."

• "¿Puedes contarme sobre el hilo de notificación 12345?"

• "Darme de baja del hilo 12345."

• "¿Qué notificaciones tengo para el repositorio octocat/Hello-World?"

• "Marcar todas las notificaciones del repositorio octocat/Hello-World como leídas".

• "Vigila toda la actividad en el repositorio octocat/Hello-World".

• "Establecer el repositorio octocat/Hello-World con la configuración predeterminada (participación y @menciones)".

• "Verifique mi configuración de notificaciones para el repositorio octocat/Hello-World".

• "Silenciar todas las notificaciones del repositorio octocat/Hello-World".

Desarrollo

Manejo de URL

Este servidor convierte automáticamente las URL de la API de GitHub a sus URL de interfaz web correspondientes. Por ejemplo:

• URL de la API: https://api.github.com/repos/nodejs/node/pulls/57557

• Convertido a: https://github.com/nodejs/node/pull/57557

La conversión maneja:

• Conversión de dominio de api.github.com/repos a github.com

• Corrección de ruta para solicitudes de extracción (cambio de pulls a pull ")

• Preservación de segmentos de ruta adicionales

Estructura del proyecto

github-notifications-mcp-server/
├── src/                    # Source code
│   ├── tools/              # Tool implementations
│   ├── types/              # Type definitions
│   ├── utils/              # Utility functions
│   ├── index.ts            # Entry point
│   └── server.ts           # Server configuration
├── build/                  # Compiled JavaScript
├── .env                    # Environment variables
├── package.json            # Dependencies
├── tsconfig.json           # TypeScript configuration
└── README.md               # Documentation

Edificio

npm run build

Pruebas

Ejecute las pruebas automatizadas:

npm test

Pruebe la conversión de URL manualmente:

npm run test:url

Licencia

Instituto Tecnológico de Massachusetts (MIT)