Skip to main content
Glama
GitHub Notifications MCP Server

GitHub Notifications MCP Server

by mcollina

GitHub 通知 MCP サーバー

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

特徴

  • GitHub 通知の一覧表示とフィルタリング

  • 通知を既読にする

  • 通知スレッドの詳細を表示

  • 通知スレッドを購読または購読解除する

  • スレッドを完了としてマークする

  • リポジトリ固有の通知を管理する

  • リポジトリの通知設定(すべてのアクティビティ、デフォルト、ミュート)を制御する

Related MCP server: mcp-github-server

前提条件

  • Node.js 18以上

  • notificationsまたはrepoスコープ付きの GitHub 個人アクセストークン (クラシック)

インストール

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

    git clone https://github.com/yourusername/github-notifications-mcp-server.git
    cd github-notifications-mcp-server
  2. 依存関係をインストールする

    npm install
  3. プロジェクトを構築する

    npm run build
  4. GitHubトークンを使用して.envファイルを作成する

    GITHUB_TOKEN=your_github_personal_access_token_here

使用法

サーバーを直接実行する

npm start

Claude Desktopでの使用

サーバーを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"
      }
    }
  }
}

利用可能なツール

ツール名

説明

list-notifications

認証されたユーザーのすべての GitHub 通知を一覧表示する

mark-notifications-read

すべての通知を既読にする

get-thread

通知スレッドに関する情報を取得する

mark-thread-read

特定のスレッドを既読にする

mark-thread-done

スレッドを完了としてマークする

get-thread-subscription

スレッドの購読ステータスを取得する

set-thread-subscription

スレッドを購読する

delete-thread-subscription

スレッドの購読を解除する

list-repo-notifications

特定のリポジトリの通知を一覧表示する

mark-repo-notifications-read

リポジトリの通知を既読としてマークする

manage-repo-subscription

リポジトリのサブスクリプションを管理します: all_activity、default (参加と@メンション)、または ignore (ミュート)

プロンプトの例

サーバーが接続されたら、Claude Desktop で使用できるプロンプトの例を次に示します。

  • 「GitHub の通知を確認できますか?」

  • 「過去 24 時間の未読通知を表示してください。」

  • 「すべての通知を既読としてマークします。」

  • 「通知スレッド12345について教えていただけますか?」

  • 「スレッド 12345 から登録を解除してください。」

  • 「octocat/Hello-World リポジトリにはどのような通知がありますか?」

  • 「octocat/Hello-World リポジトリからのすべての通知を既読としてマークします。」

  • 「octocat/Hello-World リポジトリのすべてのアクティビティを監視します。」

  • 「octocat/Hello-World リポジトリをデフォルト設定 (参加と @メンション) に設定します。」

  • 「octocat/Hello-World リポジトリの通知設定を確認してください。」

  • 「octocat/Hello-World リポジトリからのすべての通知をミュートします。」

発達

URL処理

このサーバーは、GitHub APIのURLを対応するWeb UIのURLに自動的に変換します。例:

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

  • 変換後: https://github.com/nodejs/node/pull/57557

変換ハンドル:

  • api.github.com/reposからgithub.comへのドメイン変換

  • プルリクエストのパス修正( pullsをpullに変更)

  • 追加のパスセグメントの保存

プロジェクト構造

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

建物

npm run build

テスト

自動テストを実行します。

npm test

URL 変換を手動でテストします。

npm run test:url

ライセンス

マサチューセッツ工科大学

Available Tools

11 tools
delete-thread-subscriptionA

Unsubscribe from a GitHub notification thread

Inputs: thread_id (required).

get-threadC

Get information about a GitHub notification thread

Inputs: thread_id (required).

get-thread-subscriptionA

Get subscription status for a GitHub notification thread

Inputs: thread_id (required).

list-notificationsC

List GitHub notifications for the authenticated user

Inputs: all, participating, since, before, +2 more.

list-repo-notificationsC

List GitHub notifications for a specific repository

Inputs: owner (required), repo (required), all, participating, +4 more.

manage-repo-subscriptionC

Manage repository subscription settings including fine-grained notification preferences

Inputs: owner (required), repo (required), action (required), options.

mark-notifications-readC

Mark GitHub notifications as read

Inputs: last_read_at, read.

mark-repo-notifications-readC

Mark GitHub notifications for a specific repository as read

Inputs: owner (required), repo (required), last_read_at, read.

mark-thread-doneC

Mark a GitHub notification thread as done

Inputs: thread_id (required).

mark-thread-readC

Mark a GitHub notification thread as read

Inputs: thread_id (required).

set-thread-subscriptionC

Subscribe to a GitHub notification thread

Inputs: thread_id (required), ignored.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 11 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose targeting specific notification actions like listing, marking, or managing subscriptions. The descriptions precisely differentiate operations by scope (e.g., list-notifications vs. list-repo-notifications) and action type, leaving no ambiguity for agent selection.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern with hyphens, such as 'list-notifications' and 'mark-thread-read'. The naming is uniform across the set, making it predictable and easy for agents to parse and understand the intended operations.

    Tool Count5/5

    With 11 tools, the server is well-scoped for GitHub notifications, covering key operations like listing, marking, and managing subscriptions. Each tool serves a specific function without redundancy, making the count appropriate for the domain's complexity and user needs.

    Completeness5/5

    The tool set provides complete coverage for GitHub notification workflows, including CRUD-like operations (list, get, mark, delete) and lifecycle management (subscriptions, read/done status). There are no obvious gaps, ensuring agents can handle all typical notification tasks without dead ends.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      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.
      4
      ISC
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that gives Claude live access to your GitHub workspace — PR reviews, issue triaging, repo search, and weekly digest reports through natural language.
      7
      MIT