Squirrel Notifierは、mcp-gateway を経由して MCP resource update(レビュー更新イベントなど)を監視し、更新があった場合に通知を行う常駐型軽量アプリケーションです(安定版: 0.1.0)。
- mcp-gateway を経由したレビュー更新イベントの監視(resource-bridge-cliを使用)
- 更新時のトレイポップアップ通知
- ログファイルへの記録
- システムトレイ常駐
- コマンドパス、引数、Gateway URL、Resource URI、タイムアウトのカスタマイズ
Squirrel Notifier の購読機能は、以下の外部ツールと連携して動作します。
新CLI v0.7.0(Node >=26.10.0)を使用します。既存の認証キャッシュは旧名の保存先を引き続き使います。保存済みCommand Pathは自動変更しないため、新CLI配布後に利用者が新名またはそのフルパスを指定して切り替えます。
MCP リソースの購読・イベント受信を担う外部 CLI ツールです。Squirrel Notifier には同梱されていないため、別途インストールが必要です。
- リポジトリ: scottlz0310/mcp-resource-subscriber
- インストール:
pnpm add --global resource-bridge-cli@0.7.0で追加し、resource-bridge-cli --versionを確認してください。Node >=26.10.0が必要です。CLIはMCPサーバーとして登録せず、Squirrelが子プロセスとして起動します。
インストール後、アプリの「Settings」→「Command Path」にコマンド名(PATH に通っていれば resource-bridge-cli)またはフルパスを設定してください。
PR 状態の確認とマージ・クローズ済みレビューイベントの自動片付けに使います。アプリを起動するユーザーで gh auth login を済ませ、gh を PATH に配置してください。private repository は、そのユーザーが参照できるものだけ照会できます。
gh が使えない・認証や状態取得に失敗した場合はイベントを保持し、Recent activity に原因を記録します。巡回予算は初期5回・毎時25回補充を維持します。
MCP リソースイベントを配信するゲートウェイサーバーです。squirrel-notifier と同じ reviewers forest エコシステムを構成する別プロセスとして、別途起動が必要です。
- アプリの「Settings」→「Gateway URL」にエンドポイントを設定してください(例:
http://localhost:3000) - 「Resource URI」には監視対象のリソース URI を設定してください(例:
queue://review/queue)
- Windows 11 24H2 (10.0.26100) 以降を推奨
- .NET 10 SDK
- Visual Studio 2026 (WinUI3ワークロード含む)
- Windows App SDK 1.8
winui3/SquirrelNotifier.WinUI3.slnをVisual Studioで開く- 構成を
Release/x64に設定 - ビルド → ソリューションのビルド (
Ctrl+Shift+B)
# .NET SDK(global.jsonに一致するバージョン)を使用
dotnet build winui3\SquirrelNotifier.WinUI3.sln -c Release -p:Platform=x64注意: .NET SDK 10.0.102(global.jsonで指定)が必要です。
リリースページ(例: https://github.com/scottlz0310/squirrel-notifier/releases/latest )に以下の x64 向け配布物を公開しています(0.1.0 以降):
- MSI インストーラー(
SquirrelNotifier-Setup-<version>-x64.msi): ウィザード形式のインストーラー。ダブルクリックで実行できます。環境によってはインストール完了後に自動起動タスクが登録されない場合があります(その場合はセットアップ Zip のinstall.cmdから登録してください)。 - セットアップ Zip(
SquirrelNotifier-Setup-<version>-x64.zip): 実行ファイルとinstall.cmd/install.ps1/uninstall.cmd/uninstall.ps1/create-shortcuts.cmd/create-shortcuts.ps1を同梱。
セットアップ Zip を展開したフォルダで install.cmd を実行してください(PowerShell の ExecutionPolicy に関わらず動作します):
REM トレイに最小化して自動起動を設定(推奨)
install.cmd -StartMinimized
REM 標準インストール(ログイン時にウィンドウ表示)
install.cmdPowerShell スクリプトを直接実行することもできます:
# トレイに最小化してインストール(推奨)
.\install.ps1 -StartMinimized
# カスタムパスを指定してインストール
.\install.ps1 -ExePath "C:\Path\To\SquirrelNotifier.WinUI3.exe" -StartMinimizedインストールすると、次回のログインから自動的に起動します。
展開したセットアップ Zip に含まれる create-shortcuts.cmd を使って、スタートメニューやデスクトップにショートカットを作成できます:
REM スタートメニューにショートカットを作成
create-shortcuts.cmd
REM トレイ起動用ショートカットをスタートメニューとデスクトップに作成
create-shortcuts.cmd -Tray -DesktopREM タスクと設定を削除
uninstall.cmd
REM タスクのみ削除(設定は保持)
uninstall.cmd -KeepSettings# ビルド後の実行ファイルを起動
.\winui3\SquirrelNotifier.WinUI3\bin\x64\Release\net11.0-windows10.0.26100.0\SquirrelNotifier.WinUI3.exe
# トレイに最小化して起動
.\winui3\SquirrelNotifier.WinUI3\bin\x64\Release\net11.0-windows10.0.26100.0\SquirrelNotifier.WinUI3.exe --trayまたは、Visual Studioから F5 でデバッグ実行できます。
レビューイベントは、トレイアイコン付近のボタン付きポップアップで通知します。「PRを開く」「レビューする」「アプリを開く」をその場で実行でき、Windows App SDK の AppNotificationManager には依存しません。複数のイベントを受信した場合、ポップアップには最新のイベントを表示し、直近20件はメイン画面のイベント一覧から操作できます。
レートリミット解除や接続エラーなど、操作ボタンを必要としない通知はシステムトレイの標準通知として表示します。
アプリケーションを起動後、「Settings」セクションから以下の設定が可能です:
- Command Path: resource-bridge-cli の絶対パス(またはPATH内のコマンド名)
- Arguments: 必要な固定引数(スペース区切り)
- Gateway URL: mcp-gateway のエンドポイントURL(例: http://localhost:3000)
- Resource URI: 監視対象の MCP リソース URI(例: queue://review/queue)
- Timeout (ms): タイムアウトミリ秒(1〜300,000 ms)
- Checkout Mappings: reviewed 側の「レビューに対応」で使う checkout を
owner/repo=C:\src\repo形式で1行に1件指定 - レビュー自動開始: review event を受信した時点で reviewer 側エージェントを自動起動するか(既定は無効)
- 「レビューに対応」の表示: Recent review events の行に reviewed 側の起動ボタンを出すか(既定は非表示)
- ライブログの「起動設定」にモデル・effortと取得元を表示します。取得経路・適用範囲は 起動設定表示 を参照してください。
- ライブログ最前面の初期状態: 新しく開くライブログウィンドウのピン留めを初期状態で有効にするか(既定は無効)。各ウィンドウのピン留めボタンで個別に切り替えられます。
「レビュー自動開始」を有効にすると、opened / synchronized / re-review-requested のイベント受信時に「レビューする」を押したのと同じ経路でエージェントが起動します。無人で起動するため、Auto-Pause が Paused のときは自動起動せず、理由をメイン画面の「Recent activity」に記録します(Auto-Pause の強行確認ダイアログは自動起動では表示しません)。自動起動を見送ったイベントはイベント一覧に残るため、「レビューする」から手動で起動できます。
サイクル全体の運用手順は docs/review-cycle-automation.md にまとめています。
別のレビューの実行中、起動処理中(Auto-Pause の強行確認ダイアログの表示中など)、または Auto-Pause が Paused のときに届いたイベントは保留し、実行が終わった時点、起動処理がレビューを起動せずに終わった時点、または Auto-Pause の解除を確認した時点で、受信順に 1 件ずつ自動起動を再評価します。同じ PR のイベントは 1 件にまとめ、新しいほうの reason で起動します。再評価でも自動起動の設定・Auto-Pause・PR の状態(マージ・クローズ済みなら起動しない)を確認し、イベント一覧から削除されたイベントは起動しません。保留と再評価の結果は「Recent activity」に記録し、保留したことはトレイ通知にも「レビューを保留中(理由)」として表示します。前の実行のライブログウィンドウが開いている間に起動したレビューは、そのウィンドウが閉じた後にウィンドウを表示します。保留はアプリの再起動で失われますが、イベントは一覧に残るため手動で起動できます。
Auto-Pause の解除は fresh なレートリミット snapshot でしか確認できないため、保留中はレートリミットのリセット時刻を過ぎた時点で再評価し、そこで解除を確認できない場合は 15 分ごとに再評価します。レートリミット欄の「更新」やレビューの終了で解除を確認できた場合は、その時点で再評価します。待機中の実装側エージェントへ保留を伝える経路は持たないため、待機が --timeout-ms に達した場合は「Recent activity」で理由を確認してください。
自動起動の前には、PR の required checks が確定するまで(暫定の処置です)最長 12 分待ちます。GitHub CLI(gh)で 30 秒ごとに確認し、確定・失敗・上限のいずれかで起動します。gh が使えない場合は待たずに起動します。手動の「レビューする」は待ちません。詳細は docs/review-cycle-automation.md を参照してください。
「レビューに対応」は既定で非表示です。レビュー指摘への対応は、その PR を実装した CLI エージェントが同じセッションで引き受けるほうが、設計意図や棄却案をコンテキストに残したまま対応でき、リポジトリとスレッドの再調査も要らないためです(実装側は PR 作成・更新後にレビュー完了を待機します)。このボタンは reviewed 側をコールドスタートするので、その CLI を使えない場面の退避手段と位置づけています。設定で表示に切り替えると従来どおり起動・コマンドコピーができ、切り替えは再起動なしで反映されます。reviewed launcher スロットの設定欄は表示状態に関わらず常に編集できます。
launcher の作業ディレクトリはロールごとに固定されます。「レビューする」(reviewer)は %LocalAppData%\SquirrelNotifier\launcher-workspace\reviewer から起動し、対象 checkout を直接操作しません。「レビューに対応」(reviewed)は Checkout Mappings に登録した Git checkout から起動します。mapping が未設定、存在しない、Git checkout ではない、または Windows/Program Files/アプリのインストール先を指す場合は、プロセスを起動せずエラーにします。タスクスケジューラーやアプリの起動元ディレクトリには依存しません。
起動時の実効作業ディレクトリ、解決済み実行ファイル、実行形式、終了コードは winui3.log に記録されます。非ゼロ終了時は stderr の先頭3行(最大500文字)も、ANSI 制御文字の除去と既知の機密値マスキング後に記録されます。
コマンドは PATH / PATHEXT で解決されるため、npm / pnpm 経由でインストールされた .cmd シム(例: codex.cmd)もコマンド名だけで指定できます。.cmd / .bat は cmd.exe 経由で安全にラップして起動します(詳細は docs/launcher-agent-presets.md の「コマンド解決と Windows shim の起動規約」参照)。
設定は %LocalAppData%\SquirrelNotifier\settings.json に保存されます。
なお、認証トークンなどの機密情報は設定ファイルには保存せず、環境変数 MCP_PROBE_AUTH_TOKEN から子プロセスへ渡されます。
mcp-gateway が認証を要求する構成では、初回起動時に一度だけ device flow ログインが必要です。ログインが未実施のままだと、通知の購読やレビュー登録が認証エラー(HTTP 401 / AUTH_LOGIN_REQUIRED 等)で失敗します。
認証処理そのものは resource-bridge-cli が担当し、取得したトークンは %LOCALAPPDATA%\mcp-resource-subscriber\tokens.db にキャッシュされます。Squirrel Notifier はこの CLI を安全に起動する導線・状態表示・ブラウザ導線・認証後の再購読のみを担い、トークンの取得・保存・更新は行いません。
- 「Settings」→「Gateway URL」に mcp-gateway のエンドポイントを設定します。
- Gateway URL 欄の右の「ログイン」ボタン、または認証エラー時に表示される「mcp-gateway にログイン」ボタンを押します。
- 既定ブラウザで承認ページが開きます。ダイアログに表示される認証コードを入力して承認してください。
- ブラウザが自動で開けなかった場合でも、ダイアログの承認 URL と認証コードをコピーして手動で承認できます。
- 承認が完了するとキャッシュにトークンが保存され、購読が停止中/エラーだった場合は自動で再購読を開始します。
ログインの進行状況(進行中・成功・失敗・キャンセル・タイムアウト)はダイアログで区別して表示されます。アクセストークン等の機密情報は設定・ログ・プロセス引数に出力されません。
アプリを使わず、ターミナルから直接ログインすることもできます。
resource-bridge-cli --login --url <Gateway URL>表示された verification-uri(または verification-uri-complete)をブラウザで開き、user-code で承認します。
環境変数 MCP_PROBE_AUTH_TOKEN(または --auth-token)を明示指定した場合は、--login のキャッシュより常に優先されます。明示トークンが無効なために認証エラーになる場合は、再ログインでは解消しないため、環境変数側の値を確認してください。
mcp-gateway の再構築や DCR ストアのリセット後は、キャッシュ済みのクライアント登録が無効になることがあります。その場合はキャッシュを削除してから再ログインしてください。
resource-bridge-cli --logout --url <Gateway URL>
resource-bridge-cli --login --url <Gateway URL>アプリ内ログインで成功した場合、購読が停止中/エラーであれば自動で再購読します。CLI でログインした場合や購読を手動で止めていた場合は、メイン画面下部の「Start」で購読を開始してください。
初回のみ、開発環境をセットアップしてください:
# Lefthook GitフックとNuGetパッケージをセットアップ
.\scripts\setup-dev.ps1このスクリプトは以下を実行します:
- Lefthook Gitフックの設定(コミット時・プッシュ時のチェック)
- NuGetパッケージの復元
Lefthook により、以下のチェックが自動実行されます:
コミット時:
- コードフォーマットチェック(dotnet format)
- ビルドチェック(警告をエラー扱い)
プッシュ時:
- ユニットテスト実行
- コードカバレッジチェック(80%必須)
フックを一時的にスキップする場合:
git commit --no-verify
git push --no-verifydotnet test winui3/SquirrelNotifier.WinUI3.slnWindows 配布物、外部 CLI、gateway、認証、通知、WinUI を跨ぐ統合 E2E は、 Windows 統合 E2E 設計 に従って Phase 1 (GitHub-hosted の headless E2E)で検証します。実デスクトップの確認は、リリース前に AI エージェントがランブックに沿って行う方針です(#433)。
現在は Issue #184 で追跡中です。 Issue #307 の launcher resume 境界については、次のコマンドで Phase 1 の headless E2E を実行できます。
pwsh -File .\tests\e2e\scripts\Invoke-E2E.ps1 -Phase Headless
この entrypoint は実 CLI、GitHub、gateway、認証、WinUI を使用しません。配布物を含む Phase 1 の全 scenario は同じ entrypoint から実行され、配布物だけを再現する場合は次を 使用します。
pwsh -File .\tests\e2e\scripts\Invoke-E2E.ps1 -Phase Headless -Scenario distribution-install
配布物 E2E は実 publish payload、MSI、setup ZIP の生成から silent install / uninstall、 version、製品登録、Task Scheduler、cleanup までを検証します。既存インストールや 実行中プロセスを検出した場合は変更せず失敗します。
プロジェクトには厳格な品質基準が設定されています:
- StyleCop.Analyzers: コードスタイルのチェック
- Roslynator.Analyzers: コード品質の分析
- Microsoft.CodeAnalysis.NetAnalyzers: .NET公式アナライザー
- SecurityCodeScan: セキュリティ脆弱性のスキャン
- CodeQL: GitHubセキュリティスキャン
- TreatWarningsAsErrors: すべての警告をエラーとして扱う
- 目標カバレッジ: 80%(行、分岐、メソッド)
- Codecov統合: PRごとにカバレッジレポート生成
- 自動生成コードを除外:
*.g.cs,*.xaml.cs
- .editorconfig: C#コーディング規約を強制
- dotnet format: CI時に自動フォーマットチェック
# コードフォーマットの実行
dotnet format winui3/SquirrelNotifier.WinUI3.slnGitHub Actionsを使用した自動ビルド・テスト・リリースを実装しています:
- CI: プッシュ・PR時に自動ビルド・テスト・コード分析
- ビルド(Release構成、警告をエラー扱い)
- ユニットテスト(80%カバレッジ必須)
- Lint(dotnet format)
- セキュリティスキャン(CodeQL + SecurityCodeScan)
- Release: release-automate で準備 PR を作成し、マージ後の公開承認を経て x64 のタグ・draft・成果物検証・公開を実行(運用手順)
- Renovate: 依存関係の自動更新(週次)
MIT License
