n8n MCP Community

n8n MCP Community

セルフホスト版 n8n Community Edition 向けのセキュリティ重視の Model Context Protocol サーバー

AI クライアントに、セルフホスト版 n8n Community Edition 用の 44 個のツールを提供します。ワークフロー、ノード、実行、認証情報、タグ、ユーザー、診断を管理できます。有料の n8n 機能は必要ありません。このサーバーは外部の AI に接続しません。

インストール

Node.js 22 または 24、n8n の URL、n8n API キーが必要です。

インストール

npm install --global n8n-mcp-community@latest

--global はコマンドを一度インストールします。グローバルにインストールしない場合は、以下で npx を使用してください。

接続

{
  "mcpServers": {
    "n8n-community": {
      "command": "n8n-mcp-community",
      "env": {
        "N8N_API_URL": "https://n8n.example.com",
        "N8N_API_KEY": "replace-with-a-dedicated-api-key",
        "N8N_MCP_MODE": "read-only"
      }
    }
  }
}

クライアントを再起動してください。44 個のツール、5 個のリソース、4 個のプロンプトが表示されます。

クライアントがコマンドを見つけられない場合は、macOS/Linux では command -v n8n-mcp-community、Windows では where n8n-mcp-community を実行してください。そのフルパスを "command" に指定します。

グローバルにインストールしない場合は、完全版ガイドに記載されているクライアント設定に、次のコマンドをコピーしてください。

npx --yes n8n-mcp-community@latest

Claude Desktop アプリでの手順を確認しますか？以下の MCPB を使用してください。更新、ロールバック、確認方法については、インストールガイドをご覧ください。

Claude Desktop：MCPB をインストールする（Node.js 不要）

1. 最新の GitHub リリースを開きます。
2. .mcpb で終わるファイルをダウンロードします。
3. Claude Desktop で Settings → Extensions → Advanced settings → Install Extension… を開きます。
4. ファイルを選択し、n8n の URL、API キー、モードを入力します。

Anthropic の MCPB ガイドにも、同じ手順が記載されています。ダウンロードの確認方法については、インストールガイドをご覧ください。

公開ビルドは、 npm または 最新の GitHub リリースからのみインストールしてください。

デモのトランスクリプトを読む。

このプロジェクトの特長

• Community Edition を第一に。 リリース対象はセルフホスト版 n8n Community Edition 向けに設計されており、有料限定の機能を利用可能であるかのように提示しません。
• 44 個の実用的なツール、明確な契約。 すべてのツールに、制限された入力、文書化された副作用、MCP の安全性アノテーション、契約テストがあります。
• デフォルトで安全。 デフォルトは読み取り専用モードです。書き込みやツールセット全体を許可するタイミングは、ユーザーが選べます。
• 決定論的な Introspect。 n8n_introspect はローカルの 23 ルールエンジンを実行します。ワークフローを実行したり、エージェントを呼び出したり、外部モデルに接続したりしません。
• ノードを的確に更新。 n8n_update_node は、検証済みのノードパスを 1 つ変更し、ワークフローの残りの部分を保持するとともに、Public API の非アトミックな制約を明示します。
• 正確な探索。 n8n_list_node_types は、アクセス可能なワークフローで確認されたタイプのみを報告します。インストール済みカタログを完全に網羅しているとは主張しません。
• データの最小化。 汎用の公開ツールから、認証情報の値、生の実行値、ピンデータ、ワークフローの静的データが返されることはありません。

検証の根拠を見る

## 現在の検証結果

現在のソース候補は、以下の条件で検証済みです。

• 実際の stdio で、ツール 44 個、リソース 5 個、プロンプト 4 個を正確に提供すること；
• Node.js 24.21.0 でローカルのテスト 320 件がすべて合格すること。CI とリリースゲートでは、固定された Node.js 22.23.1 と 24.18.0 のマトリックスが必須です；
• Gitleaks、Semgrep、Trivy、およびプロジェクトルートでの本番用／全依存関係用 npm audit の両方で、検出事項がゼロであること。3 つすべてのソーススキャナーを、変更不可能なスキャナー／アクションの ID とともに CI で再現すること；
• オーバーライドを使用しない独立したコンシューマーインストールで、パッチ適用済みの @hono/node-server 2.x 系統が解決され、本番用監査で検出事項がゼロであることを必須とし、stdio ランタイムと正確な 44/5/4 の内訳が確認されること；
• インストール済みパッケージのパス 187 件を対象とする、再現可能な依存関係ライセンスゲート；
• 同一オリジン HTTP コントラクトの上限設定、およびリクエスト数ゼロのポリシー拒否テスト；
• 送信接続を隔離し、キーを失効させ、クリーンアップを行って残留物がゼロである状態で、使い捨ての n8n Community 2.30.5 および 2.30.7 インスタンス上で、コンパイル済みツール 44 個すべてのライフサイクルを検証すること；
• プロジェクトでコミット済みの依存関係ポリシーに基づく、レビュー済みのオフライン npm tarball インストールに加え、同一のコンパイル済みランタイムと本番依存関係の完全な通知を含む、バイト単位で再現可能な未署名 MCPB。

公開は、レビュー済みのリリース手順を通じてのみ実施されます。この手順では、リポジトリで固定された MCPB 署名 ID、人間が発行するアーティファクトベースラインの受領証、タグに限定された保護環境での承認、およびレビュー済みの未署名候補とのバイト単位の照合によって検証された、外部署名済み MCPB の引き渡しが必要です。

安全モード

モード	許可される操作	必須の設定
読み取り専用	読み取り専用ツールのみ	デフォルト、または N8N_MCP_MODE=read-only
書き込み	読み取り専用ツールと通常の変更ツール	N8N_MCP_MODE=write
安全制限なし	破壊的操作や外部への接続を伴う操作を含む、すべてのツール	N8N_MCP_MODE=unsafe

安全制限なしモードを選択すると、安全制限のないツールに対するサーバー側の認可ゲート全体が有効になります。MCP の安全性アノテーションは正確なまま維持されるため、互換性のあるクライアントではネイティブの承認 UX を適用できます。また、n8n API キーがアップストリームの最終的な権限境界となります。

ループバック URL では、平文 HTTP は自動的に許可されます。ループバック以外の HTTP インスタンスでは、さらに N8N_ALLOW_INSECURE_HTTP=1 が必要です。この設定は、通信中に API キーやデータが公開されるリスクを受け入れます。

ツールカタログ

各項目から、入力、出力、エンドポイント、互換性、エラー、およびセキュリティに関する完全なリファレンスに移動できます。

ワークフロー

ツール	モード	目的
n8n_workflows_list	読み取り専用	範囲が制限されたフィルターとページネーションを使用して、アクセス可能なワークフローを一覧表示します。
n8n_workflows_get	読み取り専用	ピン留めデータと静的データの値を除外して、1つのワークフローを読み取ります。
n8n_workflows_create	書き込み	Public API を通じて、検証済みのワークフローを作成します。
n8n_workflows_update	書き込み	省略されたフィールドを保持しながら、選択したフィールドを保護して更新します。
n8n_update_node	書き込み	非アトミックな同時実行ガードを使用して、検証済みノードのプロパティを1つ変更します。
n8n_workflows_delete	危険	1つのワークフローを完全に削除します。
n8n_workflows_activate	危険	1つのワークフローを有効化します。
n8n_workflows_deactivate	危険	1つのワークフローを無効化します。
n8n_workflows_get_version	読み取り専用	保持されている過去のワークフローバージョンを1つ取得します。
n8n_workflows_get_tags	読み取り専用	ワークフローに割り当てられたタグを一覧表示します。
n8n_workflows_update_tags	書き込み	ワークフローに割り当てられたすべてのタグを置き換えます。
n8n_workflows_archive	危険	1つのワークフローをアーカイブします。
n8n_workflows_unarchive	危険	アーカイブされたワークフローを1つ復元します。
n8n_workflows_diff	読み取り専用	生の値を返さずに、ノードと接続を比較します。

実行

ツール	モード	目的
n8n_executions_list	読み取り専用	値を含まないデータの有無の概要とともに、実行メタデータを一覧表示します。
n8n_executions_get	読み取り専用	ワークフローペイロードを返さずに、1つの実行のメタデータを読み取ります。
n8n_executions_delete	危険	保存された実行を完全に削除します。
n8n_executions_retry	危険	再試行可能な保存済み実行を再試行します。
n8n_executions_stop	危険	停止可能な実行を1つ停止し、検証済み入力から識別情報を紐付けます。

認証情報

ツール	モード	目的
n8n_credentials_create	書き込み	値を返さずに認証情報を作成します。
n8n_credentials_delete	危険	1 件の認証情報を完全に削除します。
n8n_credentials_schema	読み取り専用	認証情報タイプの公開スキーマを読み取ります。
n8n_credentials_list	読み取り専用	n8n 2.30.5 および 2.30.7 で検証済みの認証情報メタデータを一覧表示します。
n8n_credentials_get	読み取り専用	1 件の認証情報の公開メタデータを読み取ります。
n8n_credentials_update	書き込み	シークレットを表示せずに、認証情報のメタデータまたは値を更新します。
n8n_credentials_test	危険	保存済みの認証情報をテストします。外部サービスに接続する場合があります。
n8n_credentials_usage	読み取り専用	1 ページに限定したワークフロー内で、認証情報 ID の完全一致参照を検索します。

タグ

ツール	モード	目的
n8n_tags_list	読み取り専用	ワークフローのタグを一覧表示します。
n8n_tags_get	読み取り専用	1 件のタグを読み取ります。
n8n_tags_create	書き込み	現行の 1～24 文字の制限内でタグを作成します。
n8n_tags_update	書き込み	現行の 1～24 文字の制限内でタグ名を変更します。
n8n_tags_delete	危険	1 件のタグを完全に削除します。

ユーザー

ツール	モード	目的
n8n_users_list	読み取り専用	API キーから参照できるユーザーを一覧表示します。
n8n_users_get	読み取り専用	固定 ID または完全一致するメールアドレスでユーザーを読み取ります。
n8n_users_create	危険	メンバーまたは管理者を招待します。
n8n_users_delete	危険	サポートされていない移行に関する主張を伴わずに、API から削除可能なユーザーを 1 人削除します。

診断とインスタンスメタデータ

ツール	モード	目的
n8n_health	読み取り専用	同一オリジンのヘルスチェックを範囲を限定して実行します。
n8n_insights_summary	読み取り専用	任意の日付フィルターを指定して、公式のインサイト概要を読み取ります。
n8n_audit_generate	危険	n8n のインスタンスセキュリティ監査を生成します。
n8n_search_workflows	読み取り専用	ワークフローの 1 ページを、名前、ノードタイプ、またはタグでローカル検索します。
n8n_get_node_docs	読み取り専用	変更不可の 4 つのオフラインコアノードリファレンスのいずれか 1 つを読み取ります。
n8n_list_node_types	読み取り専用	アクセス可能なワークフローページの範囲内で確認されたノードタイプを一覧表示します。
n8n_introspect	読み取り専用	ローカルで決定論的なワークフローおよび実行診断を実施します。
n8n_community_packages_list	読み取り専用	変更経路を伴わずに、インストール済みコミュニティパッケージのメタデータを一覧表示します。

リソースとプロンプト

サーバーは、次の 5 つの静的リソースも公開します。

• n8n://usage-guide
• n8n://node-docs/webhook
• n8n://node-docs/code
• n8n://node-docs/http-request
• n8n://node-docs/if

4 つのプロンプトで、安全なワークフローの作成、デバッグ、最適化、 認証情報の管理をガイドします。プロンプトは create-workflow、debug-workflow、 optimize-workflow、manage-credentials です。

1 分でわかるセキュリティモデル

• サーバーはローカルの stdio を使用し、インバウンド HTTP リスナーを公開しません。
• 接続リクエストは同一オリジンで、設定された n8n ホストに限定されます。
• リダイレクトは拒否され、リクエスト本文とレスポンス本文は 2 MiB に制限されます。
• 汎用出力は検証、サニタイズされ、256 KiB に制限されたうえで、 { "data": ..., "redacted": boolean, "untrusted": true } としてラップされます。
• 生の認証情報の値と、汎用的な実行ペイロードの値は返されません。
• n8n_introspect は固定されたローカルルールを使用し、外部モデルのコードパスはありません。
• セキュリティ制御によってリスクは軽減されますが、信頼できない n8n コンテンツを 安全に実行できるようになったり、API キーの権限を広げる許可が与えられたりするわけではありません。

セキュリティモデルの全文を読み、脆弱性を非公開で報告する場合は SECURITY.md を使用してください。

ドキュメント

• ドキュメント一覧
• はじめに
• インストールとアップグレード
• 設定
• ツールリファレンス全文
• テスト済みの例
• FAQ
• クライアント設定
• アーキテクチャ
• セキュリティモデル
• 互換性
• トラブルシューティング
• 来歴
• ロードマップ
• 変更履歴

開発

npm ci
npm run verify:contributor
npm run sbom > sbom.cdx.json

npm run verify:contributor は、フォーマット、依存関係のライセンスと通知、厳格な TypeScript チェック、すべてのテスト、 コンパイル済みランタイム、ドキュメント目録の一致確認を含む、キー不要のコントリビューター向けゲート全体を実行します。 変更を提出する前に CONTRIBUTING.md をご確認ください。

対象範囲と非提携について

このプロジェクトは、n8n GmbH との提携、同社からの承認または後援を受けていません。 「n8n」は、n8n 製品および Public API との互換性を示す目的でのみ使用しています。このプロジェクトは、n8n-nodes-base カタログを再配布せず、カタログの構築にブラウザーの Cookie、対話型セッションのルート、実行時のパッケージダウンロードを使用しません。

v0.3.x の機能範囲には、任意のワークフロー実行、認証情報／ワークフローの転送、フォルダー、データテーブル、ベータ版評価エンドポイント、実行アノテーションは意図的に含まれていません。リリース対象外として維持されるアノテーション案については、ロードマップを参照してください。

ライセンスとメンテナー

このプロジェクトはMIT ライセンスの下でリリースされています。サードパーティの依存関係には、それぞれ独自のライセンスが適用されます。

Dr. Walter Zamarian Jr.が作成および保守しています。