GitHub Notifications MCP Server
GitHub 通知 MCP サーバー
GitHub 通知を管理するためのツールを提供する MCP (Model Context Protocol) サーバー。このサーバーにより、Claude などの AI アシスタントが自然言語コマンドを通じて GitHub 通知の管理を支援できるようになります。
特徴
GitHub 通知の一覧表示とフィルタリング
通知を既読にする
通知スレッドの詳細を表示
通知スレッドを購読または購読解除する
スレッドを完了としてマークする
リポジトリ固有の通知を管理する
リポジトリの通知設定(すべてのアクティビティ、デフォルト、ミュート)を制御する
Related MCP server: mcp-github-server
前提条件
Node.js 18以上
notificationsまたはrepoスコープ付きの GitHub 個人アクセストークン (クラシック)
インストール
このリポジトリをクローンする
git clone https://github.com/yourusername/github-notifications-mcp-server.git cd github-notifications-mcp-server依存関係をインストールする
npm installプロジェクトを構築する
npm run buildGitHubトークンを使用して
.envファイルを作成するGITHUB_TOKEN=your_github_personal_access_token_here
使用法
サーバーを直接実行する
npm startClaude 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"
}
}
}
}利用可能なツール
ツール名 | 説明 |
| 認証されたユーザーのすべての GitHub 通知を一覧表示する |
| すべての通知を既読にする |
| 通知スレッドに関する情報を取得する |
| 特定のスレッドを既読にする |
| スレッドを完了としてマークする |
| スレッドの購読ステータスを取得する |
| スレッドを購読する |
| スレッドの購読を解除する |
| 特定のリポジトリの通知を一覧表示する |
| リポジトリの通知を既読としてマークする |
| リポジトリのサブスクリプションを管理します: 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 testURL 変換を手動でテストします。
npm run test:urlライセンス
マサチューセッツ工科大学
Available Tools
11 toolsdelete-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
Scored across 11 tools
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.
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.
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.
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
Related MCP Connectors
An MCP server that gives your AI access to the source code and docs of all public github repos
Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.
An MCP server that integrates with Discord to provide AI-powered features.
GitHub Copilot MCP: code, repo, PR, workflow tools for AI assistants.
Related MCP Servers
- AlicenseBqualityDmaintenanceAn 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.4ISC
- AlicenseBqualityDmaintenanceAn MCP server that enables managing GitHub repositories, pull requests, issues, and more through natural language in Cursor or Claude Desktop.3916 npm4MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server that enables AI assistants like Claude to interact with the GitHub API directly.16 npmMIT
- AlicenseAqualityDmaintenanceAn MCP server that gives Claude live access to your GitHub workspace — PR reviews, issue triaging, repo search, and weekly digest reports through natural language.7MIT