MM

mcollina/mcp-github-notifications

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

16 stars 6 forks 质量 65 趋势 21MIT

用于 OSS 维护者的 Github 通知 API 的 MCP 服务器

概览

MCP(模式上下文协议)服务器,提供管理GitHub通知的工具. 此服务器允许克洛德等AI助手通过自然语言命令帮助您管理您的 GitHub 通知. - 列出和过滤您的 GitHub 通知 - 将通知标为已读 - 查看通知线索细节 - 从通知线索中订阅或取消订阅 - 已完成的标记线索 - 管理寄存器特定通知 - 控制寄存器通知设置(所有活动、默认或变音) - Node.js 18或更高 -- -- GitHub个人访问Token(经典),通知或重播范围 4. 用您的 GitHub 令牌创建 .env 文件 将服务器添加到您的 Claude desktop config.json 文件 : 以下是一些实例提示, 您可以在服务器连接后与 Claude Desktop 一起使用 : - "你能检查我的GitHub通知吗?" - "给我看看我过去24小时的未读通知".

概述(AI 翻译)

MCP(模式上下文协议)服务器,提供管理GitHub通知的工具. 此服务器允许克洛德等AI助手通过自然语言命令帮助您管理您的 GitHub 通知.

□ 特性

  • 列出和过滤您的 GitHub 通知
  • 将通知标为已读
  • 查看通知线索细节
  • 订阅或退出通知线索
  • 标出线程
  • 管理特定存储库的通知
  • 控制寄存器通知设置(所有活动、默认或变音)

□ 先决条件

  • 节点.js 18或以上
  • GitHub 个人访问Token(经典),范围为[[T0]或repo

□ 安装

  1. 克隆此存储器

  2. 安装依赖关系

  3. 建设项目

  4. 用您的 GitHub 令牌创建 .env 文件

□ 使用量

QQ 直接运行服务器

使用 Claude 桌面

将服务器添加到您的 [[T3] 文件 :

□ 可用的工具

| 工具名 | 描述 | |-|-|-. QQ[ [T4]] 列出所有已认证用户的 GitHub 通知 QQ 将所有通知标为 QQ

本页由 AI 翻译,技术细节请以原文为准。

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.”
在 GitHub 查看完整 README

安装

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

Open the repository installation guide 新手?先看 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" } } } }