
n8n-mcp
n8n-mcp は Model Context Protocol (MCP) サーバーで、Claude Desktop、Cursor、Windsurf などの AI アシスタントに n8n の 1,084 以上のノード、ドキュメント、テンプレート、管理ツールへの完全なアクセスを提供します。これにより、AI が自律的に本番環境レベルのワークフローを構築・検証・デプロイできるようになります。
概要
n8n-mcp は、AI コーディングアシスタントと n8n ワークフロー自動化プラットフォームを繋ぐオープンソースの Model Context Protocol (MCP) サーバーです。Claude Desktop、Claude Code、Cursor、Windsurf、VS Code などのツールに、n8n の全エコシステムに関する構造化されたリアルタイムの知識を提供します(537 のコアノード + 547 のコミュニティノード、合計 1,084 ノード、2,709 のワークフローテンプレート、AI 専用検証ロジックを含む)。
軽量な Node.js アプリケーションとして構築され、組み込みの SQLite データベースを搭載。応答時間は 12ms 未満で、stdio モードまたは HTTP モードで動作します。一度接続すれば、AI がコピー&ペーストや手動設定なしで、完全な n8n ワークフローを構築・検証・テスト・デプロイできます。
ホスティング版(すぐに使える Chat Agent 付き)は n8n-mcp.com で利用可能(無料プラン + 有料プラン)。GitHub リポジトリは MIT ライセンスで完全なセルフホスティングに対応しています。
主な機能
- 包括的なノード知識ベース — 1,084 の n8n ノードに完全アクセス(プロパティカバー率 99%、オペレーションカバー率 63.6%、公式ドキュメントカバー率 87%)。n8n 新リリース後 48 時間以内に更新。
- スマート検索・発見機能 —
search_nodes、get_node(複数詳細モード)、コミュニティノードのソース別フィルタリング(verified/community)。 - 実世界の使用例 — 人気テンプレートから抽出された 2,646 の設定。
- 高度な検証機能 —
validate_nodeとvalidate_workflow。AI エージェントプロファイル、ランタイムチェック、依存関係分析を搭載。n8n v2.17+ の AI Agent ワークフローに対応。 - テンプレートエンジン — 2,709 以上のすぐに使えるワークフロー JSON を検索・取得。スマートフィルタリング対応。
- n8n 管理ツール(オプションの API 接続) — 既存の n8n インスタンス内でワークフローの作成・更新・テスト・実行・自動修正が可能。
- パフォーマンスと互換性 — 平均応答約 12ms、メモリ使用量 70–120 MB。任意の Node.js バージョンで動作。stdio(Claude Desktop)および HTTP/SSE モードをサポート。
- プライバシーとセキュリティ — オプションの匿名テレメトリ(簡単に無効化可能)、ハードコードされた認証情報なし、Webhook セキュリティモード対応。
インストールとセットアップ
クイックスタート(npx – インストール不要)
npx n8n-mcp
Claude Desktop の claude_desktop_config.json に追加し、MCP_MODE=stdio を設定してください。
Docker(本番環境推奨)
docker pull ghcr.io/czlonkowski/n8n-mcp:latest
docker run -i ghcr.io/czlonkowski/n8n-mcp:latest
クラウド(ワンクリック)
リポジトリのテンプレートを使って Railway に無料デプロイ可能。
ローカル完全ビルド
git clone https://github.com/czlonkowski/n8n-mcp.git
cd n8n-mcp
npm install
npm run build
npm run rebuild
npm start
オプションの環境変数:N8N_API_URL、N8N_API_KEY(直接ワークフロー管理用)、LOG_LEVEL=error、MCP_MODE=stdio。
対応 AI アシスタント
- Claude Desktop / Claude Code
- Cursor
- Windsurf
- VS Code + Codex
- Antigravity
- その他 MCP 対応クライアント(ホスティングサービスで 20 以上のツール対応)
ユースケース
- AI 主導のワークフロー作成 — 「Twitter のメンションを監視し、感情分析付きの要約を Slack に投稿」という指示 → AI が完全な JSON を生成・検証・デプロイ。
- 既存ワークフローのメンテナンス — ライブワークフローを読み取り、最適化を提案し、対象部分を更新。
- テンプレート探索 — 「コミュニティノードを使った最適な CRM 同期テンプレート」を尋ねると、すぐにインポート可能な JSON を取得。
- エンタープライズ自動化 — セルフホスト n8n インスタンスに接続し、大規模で安全・監査可能なワークフロー生成を実現。
- 学習とプロトタイピング — 検証ツールを使って、本番投入前に AI にベストプラクティスを教える。
n8n 組み込み MCP と n8n-mcp の違い
n8n のネイティブ MCP サーバー(最近のリリースで利用可能)は、自分のワークフローをツールとして公開します。一方、n8n-mcp は 補完的な外部 MCP サーバーで、n8n ノード知識 と AI 支援によるワークフロー作成に特化しています。両方を併用すると最大の効果を発揮します:ネイティブサーバーでワークフローをトリガーし、n8n-mcp でインテリジェントなワークフロー構築を行う。
リンクとリソース
- GitHub: czlonkowski/n8n-mcp
- ホスティング版 Chat Agent & ダッシュボード: n8n-mcp.com
- 無料プラン:ホスティング版は 1 日 100 回のツール呼び出し、セルフホストは無制限
- ドキュメントと例はリポジトリ内に記載
n8n-mcp は、どんな AI コーディングアシスタントも即座にフルスタックの n8n ワークフローエキスパートに変えます。