MCP Github Notifications

🚀 GitHub 通知 MCP サーバー

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

🚀 クイックスタート

このサーバーを使用することで、AI アシスタントが自然言語コマンドを通じて GitHub 通知を管理するのを支援します。以下に、サーバーの機能や使い方を説明します。

✨ 主な機能

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

📦 インストール

前提条件

• Node.js 18 以上
• notifications または repo スコープを持つ GitHub 個人用アクセストークン (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"
      }
    }
  }
}

利用可能なツール

サンプルのプロンプト

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 インターフェイス 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/                    # ソースコード
│   ├── tools/              # ツールの実装
│   ├── types/              # 型定義
│   ├── utils/              # ユーティリティ関数
│   ├── index.js           # エントリーファイル
│   └── package.json       # 依存関係とスクリプトを含むファイル
└── build/                 # ビルド出力ディレクトリ、実行可能ファイルを含む

ビルド方法

プロジェクトのルートディレクトリで以下のコマンドを実行します。

npm run build

これにより、webpack を使用してすべてのモジュールが build/main.js にパッケージ化され、ビルド完了後に関連情報が提供されます。

📄 ライセンス

このプロジェクトのライセンス情報については、LICENSE ファイルを参照してください。

このサーバーは、自然言語処理と自動化スクリプトを使用して、GitHub 通知を効率的に管理するための MCP サーバーです。