de en es ja ko ru zh

n8n-workflow-builder-mcp

Name: n8n-workflow-builder-mcp
Author: ifmelate

by ifmelate

Overview Schema Related Servers Score Discussions

JavaScript

Local

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-builder

主な機能

ワークフロー管理: 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ワークフローを作成	`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` (nodes, connections), `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 は警告をエラーに昇格させ、さらに有効化されたノードが（直接または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ライセンス

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

4wRelease cycle

13Releases (12mo)

Issues opened vs closed

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Appeared in Searches

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

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