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)

Prerrequisitos

Node.js 18 o superior
Token de acceso personal de GitHub (clásico) con notifications o alcance repo

Instalación

Clonar este repositorio
git clone https://github.com/yourusername/github-notifications-mcp-server.git cd github-notifications-mcp-server
Instalar dependencias
npm install
Construir el proyecto
npm run build
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

Nombre de la herramienta	Descripción
`list-notifications`	Listar todas las notificaciones de GitHub para el usuario autenticado
`mark-notifications-read`	Marcar todas las notificaciones como leídas
`get-thread`	Obtener información sobre un hilo de notificaciones
`mark-thread-read`	Marcar un hilo específico como leído
`mark-thread-done`	Marcar un hilo como terminado
`get-thread-subscription`	Obtener el estado de suscripción para un hilo
`set-thread-subscription`	Suscribirse a un hilo
`delete-thread-subscription`	Darse de baja de un hilo
`list-repo-notifications`	Lista de notificaciones para un repositorio específico
`mark-repo-notifications-read`	Marcar las notificaciones de un repositorio como leídas
`manage-repo-subscription`	Administrar suscripciones al repositorio: all_activity, predeterminado (participación y @menciones) o ignorar (silenciar)

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)

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Un servidor MCP que permite a los asistentes de IA como Claude ayudar a los usuarios a administrar sus notificaciones de GitHub a través de comandos de lenguaje natural.

Related MCP Servers

GitHub MCP Server
ualUsham
-
security
F
license
-
quality
An MCP server that enables Claude and other compatible LLMs to interact with the GitHub API, supporting features like creating issues, retrieving repository information, listing issues, and searching repositories.
Last updated -
TypeScript
GitHub MCP Server
alsonwangkhem
A
security
F
license
A
quality
An MCP server that allows Claude and other MCP-compatible LLMs to interact with the GitHub API, supporting features like creating issues, getting repository information, listing issues, and searching repositories.
Last updated -
4
TypeScript
GitHub CLI MCP Server
CodingButterBot
-
security
A
license
-
quality
An MCP server that wraps around the GitHub CLI tool, allowing AI assistants to interact with GitHub repositories through commands for pull requests, issues, and repository operations.
Last updated -
5
TypeScript
MIT License
GitLab MCP for Code Review
mehmetakinn
-
security
A
license
-
quality
An MCP server that integrates AI assistants like Claude with GitLab's merge requests, allowing them to review code changes, add comments, and approve/unapprove merge requests directly through the GitLab API.
Last updated -
19
Python
MIT License

View all related MCP servers

GitHub Notifications MCP Server