GitHub Notifications MCP Server

GitHub Notifications MCP Server

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

機能

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

前提条件

• Node.js 18 以降
• notifications または repo スコープを持つ GitHub Personal Access Token（classic）

インストール

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（参加中および @mentions）、または ignore（ミュート）

プロンプトの例

サーバーに接続した後、Claude Desktop で使用できるプロンプトの例を以下に示します：

• 「GitHub の通知を確認してもらえますか？」
• 「過去 24 時間の未読通知を表示してください。」
• 「すべての通知を既読にしてください。」
• 「通知スレッド 12345 について教えてもらえますか？」
• 「スレッド 12345 の購読を解除してください。」
• 「octocat/Hello-World リポジトリにはどのような通知がありますか？」
• 「octocat/Hello-World リポジトリからのすべての通知を既読にしてください。」
• 「octocat/Hello-World リポジトリのすべてのアクティビティをウォッチしてください。」
• 「octocat/Hello-World リポジトリをデフォルト設定（参加中および @mentions）にしてください。」
• 「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

ライセンス

MIT