MM

mcollina/mcp-github-notifications

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

16 stars 6 forks Качество 65 Тренд 21MIT

Сервер MCP для API уведомлений github для поддержки OSS

Обзор

Сервер MCP (Model Context Protocol), который предоставляет инструменты для управления уведомлениями GitHub. Этот сервер позволяет помощникам ИИ, таким как Клод, управлять уведомлениями GitHub с помощью команд естественного языка. - Перечислите и отфильтровайте свои уведомления GitHub - Уведомления Mark в прочтении - Просмотр деталей потока уведомлений - Подписаться или отказаться от подписки на потоки уведомлений - Подписаться на потоки уведомлений - Управлять уведомлениями, специфичными для репозитория - Настройки уведомлений Control repository (все действия, по умолчанию или приглушенные) Node.js 18 или выше - токен личного доступа GitHub (классический) с уведомлениями или областью репо 4. Создайте файл .env с помощью токена GitHub Добавьте сервер в файл claude desktop config.json: Вот несколько примеров подсказок, которые вы можете использовать с Claude Desktop после подключения к серверу: - "Можете ли вы проверить мои уведомления на GitHub?" - "Покажите мне мои непрочитанные уведомления за последние 24 часа". - "Отметьте все мои уведомления как прочитанные".

Обзор (машинный перевод)

Сервер MCP (Model Context Protocol), который предоставляет инструменты для управления уведомлениями GitHub. Этот сервер позволяет помощникам ИИ, таким как Клод, управлять уведомлениями GitHub с помощью команд естественного языка.

Особенности

Список и фильтрация уведомлений GitHub

  • Маркировать уведомления, как прочитано Посмотреть детали потока уведомлений Подписаться или отписаться от потоков уведомлений
  • Маркировать нити как сделано
  • Управление уведомлениями, относящимися к репозиториям
  • Настройки уведомлений репозитория управления (все действия, по умолчанию или немые)

Предпосылки

Node.js 18 или выше

  • GitHub Personal Access Token (классический) с областью notifications или repo

##Установка

  1. Клонировать это хранилище

2.Установка зависимостей

3.Создать проект

  1. Создайте файл .env с токеном GitHub

Использование

Запуск сервера напрямую

Использование с Claude Desktop

Добавьте сервер в свой claude_desktop_config.json файл:

Доступные инструменты

Название инструмента | Описание [скрыто] [скрыто] [скрыто] [скрыто] [скрыто] list-notifications Перечислите все уведомления GitHub для аутентифицированного пользователя [[Т5]] Отметьте все уведомления как прочитанные

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

GitHub Notifications MCP Server

An MCP (Model Context Protocol) server that provides tools for managing GitHub notifications. This server allows AI assistants like Claude to help you manage your GitHub notifications through natural language commands.

Features

  • List and filter your GitHub notifications
  • Mark notifications as read
  • View notification thread details
  • Subscribe or unsubscribe from notification threads
  • Mark threads as done
  • Manage repository-specific notifications
  • Control repository notification settings (all activity, default, or mute)

Prerequisites

  • Node.js 18 or higher
  • GitHub Personal Access Token (classic) with notifications or repo scope

Installation

  1. Clone this repository

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

    npm install
    
  3. Build the project

    npm run build
    
  4. Create a .env file with your GitHub token

    GITHUB_TOKEN=your_github_personal_access_token_here
    

Usage

Running the server directly

npm start

Using with Claude Desktop

Add the server to your claude_desktop_config.json file:

{
  "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"
      }
    }
  }
}

Available Tools

Tool Name Description
list-notifications List all GitHub notifications for the authenticated user
mark-notifications-read Mark all notifications as read
get-thread Get information about a notification thread
mark-thread-read Mark a specific thread as read
mark-thread-done Mark a thread as done
get-thread-subscription Get subscription status for a thread
set-thread-subscription Subscribe to a thread
delete-thread-subscription Unsubscribe from a thread
list-repo-notifications List notifications for a specific repository
mark-repo-notifications-read Mark notifications for a repository as read
manage-repo-subscription Manage repository subscriptions: all_activity, default (participating and @mentions), or ignore (mute)

Example Prompts

Here are some example prompts you can use with Claude Desktop once the server is connected:

  • “Can you check my GitHub notifications?”
  • “Show me my unread notifications from the last 24 hours.”
  • “Mark all my notifications as read.”
  • “Can you tell me about notification thread 12345?”
  • “Unsubscribe me from thread 12345.”
  • “What notifications do I have for the octocat/Hello-World repository?”
  • “Mark all notifications from the octocat/Hello-World repository as read.”
  • “Watch all activity on the octocat/Hello-World repository.”
Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "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" } } } }