remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

GitHub 通知 MCP サーバー

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

特徴

GitHub 通知の一覧表示とフィルタリング
通知を既読にする
通知スレッドの詳細を表示
通知スレッドを購読または購読解除する
スレッドを完了としてマークする
リポジトリ固有の通知を管理する
リポジトリの通知設定（すべてのアクティビティ、デフォルト、ミュート）を制御する

前提条件

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 build
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

ライセンス

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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Claude などの AI アシスタントが自然言語コマンドを通じてユーザーの GitHub 通知の管理を支援できるようにする MCP サーバー。

GitHub Notifications MCP Server