n8n Workflow Builder MCP

n8n Workflow Builder MCP

n8n ワークフローを構築・操作するための Model Context Protocol（MCP）サーバーです。AI にプロンプトを入力するだけで n8n ワークフローを構築できます。Claude Code、VS Code、Cursor、その他の MCP 対応クライアントで動作します。

この MCP サーバーはあなたに適していますか？

このサーバーは n8n ワークフローの JSON ファイルをローカルに書き込みます。n8n インスタンスを起動しておく必要はありません。また、n8n 1.86.0 ～ 2.6.2 に対応する同梱カタログからノードのバージョンを選択します。

次のような場合は、このサーバーをお使いください：

• オフラインでワークフローファイルを生成し、自分でインポートする（または git にコミットする）場合
• 古いセルフホスト版 n8n を使用しており、実際にサポートされているノードの typeVersion を持つワークフローが必要な場合。N8N_VERSION を使用中のバージョンに合わせて設定してください。

次のような場合は、別の方法をご検討ください：

• AI に n8n インスタンス内でワークフローを直接構築、テスト、実行させたい場合。n8n 組み込みのインスタンスレベル MCP サーバーをご利用ください。
• n8n API 経由でデプロイできる、充実したノードのドキュメントおよびテンプレートライブラリが必要な場合。czlonkowski/n8n-mcpをご利用ください。
• 2.6.2 より後に n8n に追加されたノードが必要な場合。これらはまだ同梱カタログに含まれていません。

DEMO VIDEO:

Cursor のルール

• ルールファイルは rules/n8n-mcp-server-rules.mdc にあります

主な機能

• ワークフロー管理：n8n ワークフローをプログラムで作成、更新、実行します（実行機能はまだ実装されていません）
• ノードの検出：利用可能な n8n ノードとその機能を確認できます
• 接続管理：ワークフローのノード間に接続を作成します
• AI 連携：ワークフロー内で AI コンポーネントを接続するための専用ツール
• AI に適したインターフェース：AI エージェントとの対話に特化して設計されています
• N8N バージョン管理：バージョンの自動検出と互換性処理に対応しています。184 以上の n8n バージョン（1.86.0 ～ 2.6.2）をサポートし、動的なノードのフィルタリングと、下位互換性のための「最も近い低いバージョン」との照合を行います。

前提条件

• Node.js（v18 以降）
• npm（npx コマンド用）
• MCP 対応クライアント（Claude Code、VS Code、Cursor など）

インストールとセットアップ

n8n API キーの取得

API キーは任意です。このサーバーは N8N_VERSION の検出にのみ N8N_API_URL／N8N_API_KEY を使用します。完全にオフラインで使用するには、これらを省略し、代わりに N8N_VERSION（例：N8N_VERSION=1.123.2）を設定してください。

1. ブラウザーで n8n インスタンスを開きます
2. Settings > API Keys に移動します
3. Create API Key をクリックします
4. 生成されたキーをコピーし、設定に使用します

Claude Code（推奨）

Claude Code CLI を使用して MCP サーバーを追加します：

claude mcp add n8n-workflow-builder -- npx -y n8n-workflow-builder-mcp

次に、環境変数を設定します：

claude mcp add n8n-workflow-builder \
  -e N8N_API_URL=http://localhost:5678 \
  -e N8N_API_KEY=your-n8n-api-key-here \
  -- npx -y n8n-workflow-builder-mcp

N8N_VERSION は任意です。サーバーは API から自動検出します。

VS Code／Cursor

MCP 設定ファイル（VS Code の場合は .vscode/mcp.json、Cursor の場合は .cursor/mcp.json）に追加します：

{
  "mcpServers": {
    "n8n-workflow-builder": {
      "command": "npx",
      "args": ["-y", "n8n-workflow-builder-mcp"],
      "env": {
        "N8N_API_URL": "http://localhost:5678",
        "N8N_API_KEY": "your-n8n-api-key-here"
      }
    }
  }
}

変更を反映するには、IDE を再起動してください。

開発用インストール

開発またはローカルテストを行う場合は、ソースをクローンしてビルドします：

git clone https://github.com/ifmelate/n8n-workflow-builder-mcp.git
cd n8n-workflow-builder-mcp
npm install
npm run build

次に、ビルドしたエントリーポイントを MCP クライアントに指定します：

# Claude Code
claude mcp add n8n-workflow-builder -- node /absolute/path/to/n8n-workflow-builder-mcp/dist/index.js

# VS Code / Cursor — use the same JSON config above with "command": "node" and "args": ["/absolute/path/to/dist/index.js"]

自動再ビルドを有効にして開発する場合：

npm run dev

利用可能な MCP ツール

このサーバーは、n8n ワークフローを操作するために次のツールを提供します：

コアワークフロー管理

ツール名	説明	主なパラメーター
create_workflow	新しい n8n ワークフローを作成します	workflow_name、workspace_dir
list_workflows	ワークスペース内のワークフローを一覧表示します	limit（任意）、cursor（任意）
get_workflow_details	特定のワークフローの詳細情報を取得します	workflow_name、workflow_path（任意）
validate_workflow	ノードスキーマと接続に照らしてワークフローファイルを検証します	workflow_name、workflow_path（任意）

ノード管理

ツール名	説明	主なパラメーター
add_node	ワークフローに新しいノードを追加します	workflow_name、node_type、position（任意）、parameters（任意）、node_name（任意）、typeVersion（任意）、webhookId（任意）、workflow_path（任意）、connect_from（任意）、connect_to（任意）
edit_node	ワークフロー内の既存のノードを編集します	workflow_name、node_id、node_type（任意）、node_name（任意）、position（任意）、parameters（任意）、typeVersion（任意）、webhookId（任意）、workflow_path（任意）、connect_from（任意）、connect_to（任意）
delete_node	ワークフローからノードを削除します	workflow_name、node_id、workflow_path（任意）
list_available_nodes	絞り込み機能を使って、利用可能なノードタイプを一覧表示します。タグ形式の同義語と、複数トークンの OR／AND ロジックに対応しています	search_term（任意）、n8n_version（任意）、limit（任意）、cursor（任意）、tags（任意、デフォルト：true）、token_logic（任意：「or」がデフォルト、または「and」）

接続管理

ツール名	説明	主なパラメーター
add_connection	2 つのノード間に接続を作成します	workflow_name、source_node_id、source_node_output_name、target_node_id、target_node_input_name、target_node_input_index（任意）、workflow_path（任意）
add_ai_connections	AI モデル、ツール、メモリをエージェントに接続します	workflow_name、agent_node_id、model_node_id（任意）、tool_node_ids（任意）、memory_node_id（任意）、embeddings_node_id（任意）、vector_store_node_id（任意）、vector_insert_node_id（任意）、vector_tool_node_id（任意）、workflow_path（任意）
connect_main_chain	AI ワークフローのノードを通る最小限のメインパスを構築します（トリガー → モデル → メモリ → 埋め込み → ドキュメントローダー → ベクトルストア → ベクターツール → エージェント）	workflow_name、workflow_path（任意）、dry_run（任意）、idempotency_key（任意）

ワークフローの計画と構成

ツール名	説明	主なパラメーター
plan_workflow	ワークフローを更新するための、非破壊的な計画（ノードと接続）を作成します。ファイルには書き込みません	workflow_name、target（ノード、接続）、workspace_dir（任意）
review_workflow_plan	計画をメモリ上で適用し、検証エラー、警告、修正案を返します。ファイルには書き込みません	workflow_name、plan、workflow_path（任意）
apply_workflow_plan	事前にレビューした計画を、ディスク上のワークフローに適用します（アトミック書き込み）	workflow_name、plan、workflow_path（任意）
compose_ai_workflow	接続と基本的な検証も含め、複雑な AI ワークフロー（エージェント + モデル + メモリ + 埋め込み + ベクトル + ツール + トリガー）を 1 回の呼び出しで構成します	workflow_name、plan、n8n_version（任意）

パラメーター管理

ツール名	説明	主なパラメーター
suggest_node_params	デフォルト値と必須フィールドを使用して、ノードタイプに有効な最小限のパラメーターを提案します	node_type、typeVersion（任意）、existing_parameters（任意）
list_missing_parameters	表示ルールを考慮し、ノードに不足している必須パラメーターを一覧表示します	node_type、typeVersion（任意）、parameters
fix_node_params	不足している必須フィールドにデフォルト値を適用したパラメーターを返します	node_type、typeVersion（任意）、parameters（任意）

テンプレートと検索

ツール名	説明	主なパラメーター
list_template_examples	無料テンプレートから抽出したノードの使用例を一覧表示します。node_type または template_name で絞り込めます	node_type（任意）、template_name（任意）、limit（任意）、cursor（任意）
get_n8n_version_info	現在の N8N バージョンと機能を取得します	random_string

検証の動作

validate_workflow は警告をエラーに昇格させ、さらに、有効になっているノードが推定された startNode から始まるメインチェーンに（直接または AI ポート経由で）接続されていない場合にも失敗します。接続を修正するには、connect_from／connect_to または add_ai_connections を使用してください。

トラブルシューティング

全般

1. MCP 設定を確認する — JSON が有効で、サーバー名が一致していることを確認してください。
2. Node.js を最新の LTS バージョンに更新する。
3. npx が失敗する場合は、npm キャッシュをクリアする：npm cache clean --force
4. 代替手段として、グローバルインストールを試す：npm install -g n8n-workflow-builder-mcp

Claude Code

• claude mcp list を実行して、サーバーが登録されていることを確認してください。
• claude mcp logs n8n-workflow-builder でログを確認してください。

VS Code / Cursor

• 出力パネルを確認してください。ドロップダウンから「MCP」を選択すると、サーバーログが表示されます。
• 設定 > 機能 > MCP サーバーで、サーバーが有効になっていることを確認してください。
• 設定を変更した後は、IDE を再起動してください。

プロジェクト構成

• /src：メインのソースコード
• /src/tools：MCP ツールの実装
• /src/models：データモデル
• /src/utils：ユーティリティ関数
• /src/middleware：認証とミドルウェア
• /config：設定ファイル
• /tests：テストファイル
• /workflow_nodes：n8n ノード定義
• /docs：追加ドキュメント

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

1. リポジトリをフォークします
2. フィーチャーブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

ライセンス

MIT ライセンス