GitHub 通知を管理するためのツールを提供する MCP (Model Context Protocol) サーバー。 このサーバーは、ClaudeのようなAIアシスタントが、自然言語のコマンドでGitHubの通知を管理するのに役立ちます。

##特徴

• GitHub通知の一覧とフィルタリング
• マーク通知を読み込みます
• 通知スレッドの詳細を見る
• 通知スレッドから購読または退会
• 印は行なわれます
• リポジトリ固有の通知を管理する
• リポジトリの通知設定の制御(すべてのアクティビティ、デフォルト、またはミュート)

前提条件

• Node.js 18以上
• notifications または repo スコープで GitHub パーソナルアクセストークン (classic)

インストール

1. このリポジトリをクローンする

2. 依存関係のインストール

3. プロジェクトのビルド

4. GitHubトークンで[[T2]ファイルを作成する

使用法

サーバーを直接実行する

##Claudeデスクトップでの使用

claude_desktop_config.jsonファイルにサーバーを追加します。

利用可能なツール

| 会社概要 | お問い合わせ | [list-notifications | 認証されたユーザの全てのGitHub通知を一覧表示 | | [mark-notifications-read | 読むすべての通知をマーク |

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

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.”