プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説 ログイン

n8n-guard

作者:flow-84バージョン 0.1.0i★ 0iパソコンで動くリポジトリ ↗
レジストリ名io.github.flow-84/n8n-guard

インストール方法

できること

Read-only health checks for self-hosted n8n: datastore growth, stuck runs, retention, git drift.

作者による原文

  • 接続方法 パソコンで動く
  • アカウントまたはキー N8N_API_KEY, N8N_POSTGRES_URL が必要 · 設定 2 件の入力が必要(N8N_SQLITE_PATH, N8N_GIT_REPO_PATH)
  • カテゴリ クリニック・健康

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気0/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア12/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

n8n-guard をインストールして。https://mcp.popnx.com/i/flow-84-n8n-guard.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

n8n-guard のキーが必要です(提供元のサイトで作成) · 設定を 2 項目入力 (N8N_SQLITE_PATH, N8N_GIT_REPO_PATH) · 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

AI にインストールしてもらう

このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude に MCP server n8n-guard を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "n8n-guard": { "command": "npx", "args": [ "-y", "n8n-guard" ], "env": { "N8N_API_KEY": "your-value", "N8N_SQLITE_PATH": "your-value", "N8N_POSTGRES_URL": "your-value", "N8N_GIT_REPO_PATH": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) N8N_API_KEY, N8N_POSTGRES_URL, N8N_SQLITE_PATH, N8N_GIT_REPO_PATH は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、n8n-guard のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. n8n-guard に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    n8n-guard のサイトを開く ↗

  3. 設定を 2 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • N8N_SQLITE_PATH n8n の database.sqlite ファイルのパス。SQLite でのデータストア検査に必要です。
      英語の原文を見るPath to the n8n database.sqlite file. Required for datastore checks on SQLite.
    • N8N_GIT_REPO_PATH エクスポートされたワークフロー JSON を保持しているチェックアウト。git ドリフトチェックに必要です。
      英語の原文を見るCheckout holding exported workflow JSON. Required for the git drift check.

    説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

  4. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  5. この設定を貼り付けて保存

    {
      "mcpServers": {
        "n8n-guard": {
          "command": "npx",
          "args": [
            "-y",
            "n8n-guard"
          ],
          "env": {
            "N8N_API_KEY": "your-value",
            "N8N_SQLITE_PATH": "your-value",
            "N8N_POSTGRES_URL": "your-value",
            "N8N_GIT_REPO_PATH": "your-value"
          }
        }
      }
    }

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. Claude を終了してもう一度開く

  7. 試してみる

    n8n-guard を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が n8n-guard を使っていると言うか、回答に n8n-guard のツール名が出れば接続成功です

追加の設定 5 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • N8N_URL n8n インスタンスのベース URL。既定値は http://localhost:5678 です。
    英語の原文を見るBase URL of the n8n instance. Defaults to http://localhost:5678.
  • N8N_GUARD_STUCK_MINUTES 実行が running のままでいられる分数。超えるとスタック扱いになる。既定値は 15。
    英語の原文を見るMinutes a run may stay in `running` before it counts as stuck. Defaults to 15.
  • N8N_GUARD_DB_WARN_BYTES datastore の警告しきい値(バイト単位)。デフォルトは 1073741824(1 GB)。
    英語の原文を見るDatastore warning threshold in bytes. Defaults to 1073741824 (1 GB).
  • N8N_GUARD_DB_CRITICAL_BYTES datastore の危険しきい値(バイト単位)。デフォルトは 4294967296(4 GB)。
    英語の原文を見るDatastore critical threshold in bytes. Defaults to 4294967296 (4 GB).
  • N8N_GUARD_TIMEOUT_MS リクエストごとの API タイムアウト(ミリ秒)。デフォルトは 15000。
    英語の原文を見るPer-request API timeout in milliseconds. Defaults to 15000.

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ n8n-guard につなげません

n8n-guard はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · n8n-guard につなげるアプリを使う

  • n8n-guard のキーが必要です(提供元のサイトで作成) · 設定を 2 項目入力 (N8N_SQLITE_PATH, N8N_GIT_REPO_PATH) · 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • n8n-guard のキーが必要です(提供元のサイトで作成) · 設定を 2 項目入力 (N8N_SQLITE_PATH, N8N_GIT_REPO_PATH) · 先にパソコンへ Node.js を入れてください(1 回だけ)
  • n8n-guard のキーが必要です(提供元のサイトで作成) · 設定を 2 項目入力 (N8N_SQLITE_PATH, N8N_GIT_REPO_PATH) · 先にパソコンへ Node.js を入れてください(1 回だけ)
  • n8n-guard のキーが必要です(提供元のサイトで作成) · 設定を 2 項目入力 (N8N_SQLITE_PATH, N8N_GIT_REPO_PATH) · 先にパソコンへ Node.js を入れてください(1 回だけ)

B · クリニック・健康 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

n8n-guard のキーが必要です(提供元のサイトで作成) · 設定を 2 項目入力 (N8N_SQLITE_PATH, N8N_GIT_REPO_PATH) · 先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude Code に MCP server n8n-guard を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user n8n-guard --env N8N_API_KEY=your-value --env N8N_SQLITE_PATH=your-value --env N8N_POSTGRES_URL=your-value --env N8N_GIT_REPO_PATH=your-value -- npx -y n8n-guard 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) N8N_API_KEY, N8N_POSTGRES_URL, N8N_SQLITE_PATH, N8N_GIT_REPO_PATH は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、n8n-guard のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. n8n-guard に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    n8n-guard のサイトを開く ↗

  3. 設定を 2 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • N8N_SQLITE_PATH n8n の database.sqlite ファイルのパス。SQLite でのデータストア検査に必要です。
      英語の原文を見るPath to the n8n database.sqlite file. Required for datastore checks on SQLite.
    • N8N_GIT_REPO_PATH エクスポートされたワークフロー JSON を保持しているチェックアウト。git ドリフトチェックに必要です。
      英語の原文を見るCheckout holding exported workflow JSON. Required for the git drift check.

    説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

  4. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  5. このコマンドを貼り付けて Enter

    claude mcp add --scope user n8n-guard --env N8N_API_KEY=your-value --env N8N_SQLITE_PATH=your-value --env N8N_POSTGRES_URL=your-value --env N8N_GIT_REPO_PATH=your-value -- npx -y n8n-guard

    Enter の前に「your-value」を自分のキーに書き換えてください

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. Claude Code で /mcp と入力

    n8n-guard が一覧にあり、接続済みと表示されれば OK です

  7. 試してみる

    n8n-guard を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が n8n-guard を使っていると言うか、回答に n8n-guard のツール名が出れば接続成功です

追加の設定 5 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • N8N_URL n8n インスタンスのベース URL。既定値は http://localhost:5678 です。
    英語の原文を見るBase URL of the n8n instance. Defaults to http://localhost:5678.
  • N8N_GUARD_STUCK_MINUTES 実行が running のままでいられる分数。超えるとスタック扱いになる。既定値は 15。
    英語の原文を見るMinutes a run may stay in `running` before it counts as stuck. Defaults to 15.
  • N8N_GUARD_DB_WARN_BYTES datastore の警告しきい値(バイト単位)。デフォルトは 1073741824(1 GB)。
    英語の原文を見るDatastore warning threshold in bytes. Defaults to 1073741824 (1 GB).
  • N8N_GUARD_DB_CRITICAL_BYTES datastore の危険しきい値(バイト単位)。デフォルトは 4294967296(4 GB)。
    英語の原文を見るDatastore critical threshold in bytes. Defaults to 4294967296 (4 GB).
  • N8N_GUARD_TIMEOUT_MS リクエストごとの API タイムアウト(ミリ秒)。デフォルトは 15000。
    英語の原文を見るPer-request API timeout in milliseconds. Defaults to 15000.

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

n8n-guard のキーが必要です(提供元のサイトで作成) · 設定を 2 項目入力 (N8N_SQLITE_PATH, N8N_GIT_REPO_PATH) · 先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Cursor に MCP server n8n-guard を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "n8n-guard": { "command": "npx", "args": [ "-y", "n8n-guard" ], "env": { "N8N_API_KEY": "your-value", "N8N_SQLITE_PATH": "your-value", "N8N_POSTGRES_URL": "your-value", "N8N_GIT_REPO_PATH": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) N8N_API_KEY, N8N_POSTGRES_URL, N8N_SQLITE_PATH, N8N_GIT_REPO_PATH は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、n8n-guard のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. n8n-guard に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    n8n-guard のサイトを開く ↗

  3. 設定を 2 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • N8N_SQLITE_PATH n8n の database.sqlite ファイルのパス。SQLite でのデータストア検査に必要です。
      英語の原文を見るPath to the n8n database.sqlite file. Required for datastore checks on SQLite.
    • N8N_GIT_REPO_PATH エクスポートされたワークフロー JSON を保持しているチェックアウト。git ドリフトチェックに必要です。
      英語の原文を見るCheckout holding exported workflow JSON. Required for the git drift check.

    説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

  4. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  5. キーを入力

    n8n-guard の設定で N8N_API_KEY, N8N_POSTGRES_URL, N8N_SQLITE_PATH, N8N_GIT_REPO_PATH が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. Cursor の AI チャットを Agent モードで開く

  7. 試してみる

    n8n-guard を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が n8n-guard を使っていると言うか、回答に n8n-guard のツール名が出れば接続成功です

追加の設定 5 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • N8N_URL n8n インスタンスのベース URL。既定値は http://localhost:5678 です。
    英語の原文を見るBase URL of the n8n instance. Defaults to http://localhost:5678.
  • N8N_GUARD_STUCK_MINUTES 実行が running のままでいられる分数。超えるとスタック扱いになる。既定値は 15。
    英語の原文を見るMinutes a run may stay in `running` before it counts as stuck. Defaults to 15.
  • N8N_GUARD_DB_WARN_BYTES datastore の警告しきい値(バイト単位)。デフォルトは 1073741824(1 GB)。
    英語の原文を見るDatastore warning threshold in bytes. Defaults to 1073741824 (1 GB).
  • N8N_GUARD_DB_CRITICAL_BYTES datastore の危険しきい値(バイト単位)。デフォルトは 4294967296(4 GB)。
    英語の原文を見るDatastore critical threshold in bytes. Defaults to 4294967296 (4 GB).
  • N8N_GUARD_TIMEOUT_MS リクエストごとの API タイムアウト(ミリ秒)。デフォルトは 15000。
    英語の原文を見るPer-request API timeout in milliseconds. Defaults to 15000.

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

n8n-guard のキーが必要です(提供元のサイトで作成) · 設定を 2 項目入力 (N8N_SQLITE_PATH, N8N_GIT_REPO_PATH) · 先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの VS Code に MCP server n8n-guard を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "n8n-guard": { "type": "stdio", "command": "npx", "args": [ "-y", "n8n-guard" ], "env": { "N8N_API_KEY": "your-value", "N8N_SQLITE_PATH": "your-value", "N8N_POSTGRES_URL": "your-value", "N8N_GIT_REPO_PATH": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) N8N_API_KEY, N8N_POSTGRES_URL, N8N_SQLITE_PATH, N8N_GIT_REPO_PATH は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、n8n-guard のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. n8n-guard に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    n8n-guard のサイトを開く ↗

  3. 設定を 2 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • N8N_SQLITE_PATH n8n の database.sqlite ファイルのパス。SQLite でのデータストア検査に必要です。
      英語の原文を見るPath to the n8n database.sqlite file. Required for datastore checks on SQLite.
    • N8N_GIT_REPO_PATH エクスポートされたワークフロー JSON を保持しているチェックアウト。git ドリフトチェックに必要です。
      英語の原文を見るCheckout holding exported workflow JSON. Required for the git drift check.

    説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

  4. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  5. キーを入力

    n8n-guard の設定で N8N_API_KEY, N8N_POSTGRES_URL, N8N_SQLITE_PATH, N8N_GIT_REPO_PATH が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. VS Code の AI チャットを Agent モードで開く

  7. 試してみる

    n8n-guard を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が n8n-guard を使っていると言うか、回答に n8n-guard のツール名が出れば接続成功です

追加の設定 5 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • N8N_URL n8n インスタンスのベース URL。既定値は http://localhost:5678 です。
    英語の原文を見るBase URL of the n8n instance. Defaults to http://localhost:5678.
  • N8N_GUARD_STUCK_MINUTES 実行が running のままでいられる分数。超えるとスタック扱いになる。既定値は 15。
    英語の原文を見るMinutes a run may stay in `running` before it counts as stuck. Defaults to 15.
  • N8N_GUARD_DB_WARN_BYTES datastore の警告しきい値(バイト単位)。デフォルトは 1073741824(1 GB)。
    英語の原文を見るDatastore warning threshold in bytes. Defaults to 1073741824 (1 GB).
  • N8N_GUARD_DB_CRITICAL_BYTES datastore の危険しきい値(バイト単位)。デフォルトは 4294967296(4 GB)。
    英語の原文を見るDatastore critical threshold in bytes. Defaults to 4294967296 (4 GB).
  • N8N_GUARD_TIMEOUT_MS リクエストごとの API タイムアウト(ミリ秒)。デフォルトは 15000。
    英語の原文を見るPer-request API timeout in milliseconds. Defaults to 15000.

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?n8n-guard を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user n8n-guard --env N8N_API_KEY=your-value --env N8N_SQLITE_PATH=your-value --env N8N_POSTGRES_URL=your-value --env N8N_GIT_REPO_PATH=your-value -- npx -y n8n-guard

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "n8n-guard": {
      "command": "npx",
      "args": [
        "-y",
        "n8n-guard"
      ],
      "env": {
        "N8N_API_KEY": "your-value",
        "N8N_SQLITE_PATH": "your-value",
        "N8N_POSTGRES_URL": "your-value",
        "N8N_GIT_REPO_PATH": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "n8n-guard": {
      "command": "npx",
      "args": [
        "-y",
        "n8n-guard"
      ],
      "env": {
        "N8N_API_KEY": "your-value",
        "N8N_SQLITE_PATH": "your-value",
        "N8N_POSTGRES_URL": "your-value",
        "N8N_GIT_REPO_PATH": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "n8n-guard": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "n8n-guard"
      ],
      "env": {
        "N8N_API_KEY": "your-value",
        "N8N_SQLITE_PATH": "your-value",
        "N8N_POSTGRES_URL": "your-value",
        "N8N_GIT_REPO_PATH": "your-value"
      }
    }
  }
}

自分で入力する値

  • N8N_URL env
    n8n インスタンスのベース URL。既定値は http://localhost:5678 です。
    英語の原文を見るBase URL of the n8n instance. Defaults to http://localhost:5678.
  • N8N_API_KEY 秘密 必須 env
    n8n 公開 API キー。実行およびワークフローのチェックに必要です。
    英語の原文を見るn8n Public API key. Required for the execution and workflow checks.
  • N8N_SQLITE_PATH 必須 env
    n8n の database.sqlite ファイルのパス。SQLite でのデータストア検査に必要です。
    英語の原文を見るPath to the n8n database.sqlite file. Required for datastore checks on SQLite.
  • N8N_POSTGRES_URL 秘密 必須 env
    Postgres 接続文字列。N8N_SQLITE_PATH より優先される。
    英語の原文を見るPostgres connection string. Takes precedence over N8N_SQLITE_PATH.
  • N8N_GIT_REPO_PATH 必須 env
    エクスポートされたワークフロー JSON を保持しているチェックアウト。git ドリフトチェックに必要です。
    英語の原文を見るCheckout holding exported workflow JSON. Required for the git drift check.
  • N8N_GUARD_STUCK_MINUTES env
    実行が running のままでいられる分数。超えるとスタック扱いになる。既定値は 15。
    英語の原文を見るMinutes a run may stay in `running` before it counts as stuck. Defaults to 15.
  • N8N_GUARD_DB_WARN_BYTES env
    datastore の警告しきい値(バイト単位)。デフォルトは 1073741824(1 GB)。
    英語の原文を見るDatastore warning threshold in bytes. Defaults to 1073741824 (1 GB).
  • N8N_GUARD_DB_CRITICAL_BYTES env
    datastore の危険しきい値(バイト単位)。デフォルトは 4294967296(4 GB)。
    英語の原文を見るDatastore critical threshold in bytes. Defaults to 4294967296 (4 GB).
  • N8N_GUARD_TIMEOUT_MS env
    リクエストごとの API タイムアウト(ミリ秒)。デフォルトは 15000。
    英語の原文を見るPer-request API timeout in milliseconds. Defaults to 15000.

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
5/週
接続方法
パソコンで動く
最新バージョンi
0.1.0
レジストリ公開日i
2026年11月12日
コードの最終更新i
2026年11月12日
作者
flow-84
パッケージ
npm: n8n-guard
ウェブサイト
github.com
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月20日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント flow-84 で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:8 日前

  • ✓ 合格

    ライセンスがある

    MITを使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

OSV.dev に n8n-guard@0.1.0 の登録はありません

このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月16日

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/flow-84-n8n-guard.svg)](https://mcp.popnx.com/en/servers/flow-84-n8n-guard)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

クリニック・健康のほかのサーバーとの比較i

  • このカテゴリのほかの1198件のうち0%よりスターが多い
  • このカテゴリのほかの1198件のうち81%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの1198件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

n8n-guardは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

入力が必要なもの:N8N_API_KEY, N8N_POSTGRES_URL

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は8 日前、最新バージョン(0.1.0)がレジストリに届いたのは8 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは?

同じカテゴリには:Medplum MCP, Mirobody, Codescene MCP Server, Marrow, WHOOP — MissingMCP

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

Medplum MCP

Securely access and manage FHIR healthcare data stored in Medplum.

作者:medplum広く使われている★ 28064 か月前更新

クラウドで動く✓ 提供元 · medplum.com

Mirobody

Lab results to LOINC codes and UCUM units, symptoms and diagnoses to ICPC-3. Offline, no API key.

作者:thetahealth成長中↓ 725/週★ 1618昨日更新

パソコンで動く✓ thetahealth.ai

WHOOP — MissingMCP

WHOOP recovery, strain, sleep and workouts in Claude via official WHOOP OAuth. Free, open source.

作者:VelkyVenik初期★ 21 リポジトリ全体のスター4 か月前更新

クラウドで動く✓ missingmcp.com
似たものと比べる
これ
n8n-guard
Medplum MCPMirobodyCodescene MCP ServerMarrowWHOOP — MissingMCP
動く場所パソコンにインストールが必要クラウドで動き、インストール不要パソコンにインストールが必要パソコンにインストールが必要パソコンにインストールが必要クラウドで動き、インストール不要
キーが必要はいいいえいいえいいえいいえいいえ
Claude で + から追加いいえいいえいいえいいえいいえいいえ
基本チェック3/34/43/32/33/32/4
ライセンスMITApache-2.0Apache-2.0NOASSERTIONMITMIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

n8n-guard

An MCP server for the operational layer *underneath* the n8n Public API.

Most n8n MCP servers on the registry wrap the same public endpoints: list workflows, list executions, create, activate, delete. That is useful for building workflows. It is close to useless for keeping a self-hosted instance alive, because the things that actually take an instance down are not in that API at all.

n8n-guard answers the four questions the API cannot:

  1. How big is the datastore, and when does it become a problem? The Public API has no endpoint for database size. n8n-guard reads the SQLite file or queries Postgres directly, breaks the size down per table, derives the growth rate, and tells you how many days of headroom are left.
  2. Which executions are stuck? Listing executions by status is not detection. A run sitting in running looks identical to a healthy long job until you compare it against what that workflow normally takes. n8n-guard builds a per-workflow median from finished runs and flags the outliers.
  3. What is retention costing? How many execution records are stored, how far back they reach, and what a given retention window would free.
  4. Has the instance drifted from git? Existing servers diff one API object against another. n8n-guard diffs the running instance against the JSON exports in a repository: live but never exported, exported but deleted, and content that quietly diverged.

It is strictly read-only. n8n-guard never writes to your instance, never deletes executions, and never activates or edits a workflow. It reports; you decide.

Install

npx -y n8n-guard

Requires Node.js 22 or newer (it uses the built-in node:sqlite). For a permanent install use npm install -g n8n-guard.

Claude Desktop / any MCP client
{

"mcpServers": { "n8n-guard": { "command": "n8n-guard", "env": { "N8N_URL": "https://n8n.example.com", "N8N_API_KEY": "n8n_api_...", "N8N_SQLITE_PATH": "/var/lib/n8n/.n8n/database.sqlite", "N8N_GIT_REPO_PATH": "/srv/workflow-exports" } } } }

Configuration

Everything is an environment variable. There are no hardcoded hosts, paths, container names or accounts, so the server runs against any self-hosted instance.

VariableRequiredDefaultPurpose
N8N_URLnohttp://localhost:5678Base URL of the instance
N8N_API_KEYfor execution and workflow checksnonePublic API key (Settings, n8n API)
N8N_SQLITE_PATHfor datastore checks on SQLitenonePath to database.sqlite
N8N_POSTGRES_URLfor datastore checks on PostgresnoneConnection string, takes precedence over SQLite
N8N_GIT_REPO_PATHfor the drift checknoneCheckout holding exported workflow JSON
N8N_GUARD_STUCK_MINUTESno15Minutes in running before a run counts as stuck
N8N_GUARD_DB_WARN_BYTESno1073741824 (1 GB)Datastore warning threshold
N8N_GUARD_DB_CRITICAL_BYTESno4294967296 (4 GB)Datastore critical threshold
N8N_GUARD_TIMEOUT_MSno15000Per-request API timeout

Partial configuration is a supported mode, not an error. With only N8N_URL and N8N_SQLITE_PATH you still get disk and retention answers; the API-backed checks report that they are unconfigured and the rest of the run continues.

Tools

ToolWhat it does
instance_infoReachability, configured datastore, workflow inventory. Shows which checks are usable.
db_healthDatastore size, per-table breakdown, growth rate, projected days until the critical threshold.
stuck_executionsRuns stuck in running, judged against the absolute threshold and each workflow's own median.
retention_reportExecution count, age span, and what pruning to a retention window would free.
git_driftLive workflows against the repository exports: missing, deleted, drifted, duplicated.
guard_runAll of the above in one resilient sweep. This is the one to schedule.

Example call

Point the server at an instance and let your client call a tool. Every tool answers with a readable summary first and the full structured payload after it:

## Retention report
  • 200 execution records spanning 8.3 days (24.1/day)
  • nothing older than 30 days, retention is already tight
  • n8n-guard never deletes. To act on this, set EXECUTIONS_DATA_PRUNE=true and EXECUTIONS_DATA_MAX_AGE=720 (hours) on the n8n instance, then restart it.

followed by the structured payload the summary was derived from:

{

"executionCount": 200, "oldestExecutionAt": "2026-08-28T23:43:28.651Z", "spanDays": 8.29, "executionsPerDay": 24.12, "buckets": [ { "olderThanDays": 7, "rows": 32, "share": 0.16, "estimatedBytes": 3277 }, { "olderThanDays": 30, "rows": 0, "share": 0, "estimatedBytes": 0 } ] }

guard_run wraps all six checks. With only a datastore configured it reports the gap instead of aborting:

## Guard run (degraded)
  • stuck_executions failed after 3 attempt(s): N8N_API_KEY is not set, so the n8n Public API cannot be queried
  • git_drift failed after 2 attempt(s): N8N_GIT_REPO_PATH is not set, so there is nothing to diff the instance against
  • 4 of 6 checks completed despite the failures above

Recovery: guard_run survives a partial outage

A monitoring run that aborts on the first unreachable dependency is worthless precisely when it matters. The API being down *is* the incident, and it is no reason to stop looking at the disk.

guard_run isolates every step. A failing step is retried with backoff, and if it still fails it becomes a finding while the remaining checks run to completion. Steps that depend on a failed step are skipped with the reason attached rather than crashing on missing input. The report says so plainly:

## Guard run (degraded)
  • stuck_executions failed after 3 attempt(s): cannot reach http://n8n.internal:5678: fetch failed
  • git_drift skipped: depends on instance, which failed
  • 4 of 6 checks completed despite the failures above

This behaviour is covered by tests in test/unit/runner.test.ts and test/unit/serviceRecovery.test.ts, the latter running a real SQLite datastore against a deliberately dead API endpoint.

Render Workflows

The same sweep also runs as a Render Workflow: one Render task per check, with ordering, retries and backoff declared in the task definitions and executed by Render rather than by the in-process runner. Deploy steps, the task table and how to trigger a run (including a deliberate failure that demonstrates the retry path) are in docs/render-workflow.md.

Try it on a throwaway instance

The compose file starts a fresh n8n you can safely point the server at. The data directory is bind-mounted, which is exactly how n8n-guard reads a real deployment.

git clone https://github.com/flow-84/n8n-guard && cd n8n-guard

npm install && npm run build

docker compose up -d ./scripts/demo-setup.sh # owner, API key, workflows, and a drifted export folder

The script generates the owner password, keeps it in the gitignored .n8n-demo-credentials, and prints it along with the environment block to run the server with. It seeds one workflow that matches its export, one that was never exported, one that points at a sink container so a run can hang, and one export whose workflow does not exist, so git_drift and stuck_executions have something real to find.

export N8N_URL=http://localhost:5679

export N8N_API_KEY=... # printed by the script export N8N_SQLITE_PATH=$PWD/.n8n-demo/database.sqlite export N8N_GIT_REPO_PATH=$PWD/.n8n-demo-exports npm start

The instance publishes on 5679, not on n8n's default 5678, so it cannot collide with an instance you care about. Set N8N_DEMO_PORT to move it, and pass the same value to demo-setup.sh, the integration tests and N8N_URL.

Tests

npm test              # unit tests, no instance required

npm run test:integration # against the compose instance above

The integration suite skips the API-backed cases when N8N_API_KEY is unset, so it stays runnable on a bare docker compose up.

License

MIT