n8n-workflow-builder-mcp
n8n Workflow Builder MCP
n8nワークフローを構築および操作するためのModel Context Protocol (MCP) サーバーです。AIへのプロンプトだけでn8nワークフローを構築できます。Claude Code、VS Code、Cursor、およびMCP互換クライアントで動作します。
デモ動画:
Cursorルール
ルールファイルは
rules/n8n-mcp-server-rules.mdcにあります
Related MCP server: MCP- N8N
主な機能
ワークフロー管理: 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キーの取得
ブラウザでn8nインスタンスを開く
Settings > API Keys に移動
Create API Key をクリック
生成されたキーをコピーし、設定で使用する
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ワークフローを作成 |
|
list_workflows | ワークスペース内のワークフローを一覧表示 |
|
get_workflow_details | 特定のワークフローの詳細情報を取得 |
|
validate_workflow | ノードスキーマと接続性に基づいてワークフローファイルを検証 |
|
ノード管理
ツール名 | 説明 | 主要パラメータ |
add_node | ワークフローに新しいノードを追加 |
|
edit_node | ワークフロー内の既存ノードを編集 |
|
delete_node | ワークフローからノードを削除 |
|
list_available_nodes | オプションのフィルタリング付きで利用可能なノードタイプを一覧表示。タグ形式の同義語やマルチトークンのOR/ANDロジックをサポート |
|
接続管理
ツール名 | 説明 | 主要パラメータ |
add_connection | 2つのノード間に接続を作成 |
|
add_ai_connections | AIモデル、ツール、メモリをエージェントに接続 |
|
connect_main_chain | AIワークフローノードを通る最小限のメインパスを構築 (トリガー → モデル → メモリ → エンベディング → ドキュメントローダー → ベクターストア → ベクターツール → エージェント) |
|
ワークフローの計画と構成
ツール名 | 説明 | 主要パラメータ |
plan_workflow | ワークフローを更新するための非破壊的な計画(ノードと接続)を作成。ファイルへの書き込みは行わない |
|
review_workflow_plan | 計画をメモリ上で適用し、検証エラー、警告、推奨される修正を返す。ファイルへの書き込みは行わない |
|
apply_workflow_plan | 事前にレビューされた計画をディスク上のワークフローに適用(アトミック書き込み) |
|
compose_ai_workflow | 複雑なAIワークフロー(エージェント + モデル + メモリ + エンベディング + ベクター + ツール + トリガー)を1回の呼び出しで構成(接続と基本的な検証を含む) |
|
パラメータ管理
ツール名 | 説明 | 主要パラメータ |
suggest_node_params | デフォルト値と必須フィールドを使用して、ノードタイプの最小限の有効なパラメータを提案 |
|
list_missing_parameters | 可視性ルールを考慮して、ノードに不足している必須パラメータを一覧表示 |
|
fix_node_params | 不足している必須フィールドに対してデフォルト値を適用したパラメータを返す |
|
テンプレートと探索
ツール名 | 説明 | 主要パラメータ |
list_template_examples | 無料テンプレートから抽出されたノードの使用例を一覧表示。node_typeまたはtemplate_nameでフィルタリング |
|
get_n8n_version_info | 現在のN8Nバージョンと機能を取得 |
|
検証動作
validate_workflow は警告をエラーに昇格させ、さらに有効化されたノードが(直接またはAIポート経由で)推論された startNode から始まるメインチェーンに接続されていない場合に失敗します。接続性を修正するには connect_from/connect_to または add_ai_connections を使用してください。
トラブルシューティング
全般
MCP設定を確認 — JSONが有効であり、サーバー名が一致していることを確認してください。
Node.jsを更新 — 最新のLTSバージョンに更新してください。
npmキャッシュをクリア — npxが失敗する場合:
npm cache clean --forceグローバルインストールを試す — フォールバックとして:
npm install -g n8n-workflow-builder-mcp
Claude Code
claude mcp listを実行して、サーバーが登録されていることを確認してください。claude mcp logs n8n-workflow-builderでログを確認してください。
VS Code / Cursor
出力パネルを確認 — ドロップダウンから「MCP」を選択してサーバーログを表示してください。
Settings > Features > MCP Servers でサーバーが有効になっていることを確認してください。
設定変更後はIDEを再起動してください。
プロジェクト構造
/src: メインソースコード/src/tools: MCPツール実装/src/models: データモデル/src/utils: ユーティリティ関数/src/middleware: 認証とミドルウェア/config: 設定ファイル/tests: テストファイル/workflow_nodes: n8nノード定義/docs: 追加ドキュメント
貢献
貢献を歓迎します!お気軽にプルリクエストを送信してください。
リポジトリをフォーク
フィーチャーブランチを作成 (
git checkout -b feature/amazing-feature)変更をコミット (
git commit -m 'Add some amazing feature')ブランチにプッシュ (
git push origin feature/amazing-feature)プルリクエストを開く
ライセンス
MITライセンス
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseAqualityDmaintenance🪄 MCP server for programmatic creation and management of n8n workflows. Enables AI assistants to build, modify, and manage workflows without direct user intervention through a comprehensive set of tools and resources for interacting with n8n's REST API.108184MIT
- MIT
- -license-quality-maintenanceProvides seamless integration between MCP-compatible AI assistants and n8n workflow automation, enabling intelligent management and automation of n8n workflows through natural language.5
- Alicense-qualityDmaintenanceMCP server for n8n workflow automation, enabling management of workflows, executions, credentials, tags, users, and webhooks via an MCP-compatible client.MIT
Related MCP Connectors
Create, browse, remix, collaborate on, and run durable AI workflow nodes from MCP hosts.
Your saved nanoodle workflow graphs as MCP tools — BYOK or pay per call in Nano (x402)
Self-hosted MCP gateway: turn any API, database or MCP server into AI connectors — no code.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/ifmelate/n8n-workflow-builder-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server