mcp-n8n-ビルダー
n8nワークフローをプログラム的に作成・管理するためのモデルコンテキストプロトコル（MCP）サーバー。このサーバーは、n8nのREST APIと連携するためのツールとリソースを提供し、AIアシスタントがユーザーの直接的な介入なしにワークフローを構築、変更、管理できるようにします。
特徴
🔄ワークフロー管理：ワークフローの作成、読み取り、更新、削除、有効化、無効化
📊実行管理：ワークフロー実行の詳細を一覧表示および取得する
✅スキーマ検証: 入力データと出力データの両方に対して Zod による包括的な検証
🔍ノード検証: ワークフロー作成前に、エラーを防ぐために n8n の利用可能なノードに対してノードタイプを検証します。
🤔スマートサジェスチョン: 無効なノードが検出された場合、類似のノードタイプの提案を提供します
🛠️エラー処理: トラブルシューティングのための詳細なエラーメッセージ
📝ドキュメント: すべてのツールとリソースに関する詳細なドキュメント
🔍検索とフィルター: 名前、タグ、アクティブステータスでワークフローをフィルターします
Related MCP server: n8n Workflow Builder MCP Server
構成
このサーバーはMCPクライアント経由で設定する必要があります。以下に、様々な環境における設定例を示します。
傾斜構成
Cline MCP 設定に以下を追加します:
WSL 構成の Claude デスクトップ
WSL 環境の場合は、Claude Desktop 構成に以下を追加します。
環境変数
サーバーは環境変数を使用して設定できます。
変数 | 説明 | デフォルト |
| n8n APIのURL |
|
| n8n認証用のAPIキー |
|
| MCPサーバーの名前 |
|
| MCP サーバーのバージョン | パッケージバージョン |
| ログレベル |
|
| キャッシュを有効にする |
|
| キャッシュTTL（秒） |
|
| 出力の詳細レベル（
または
） |
|
MCPツール
ノード管理
list_available_nodes: n8nインスタンスで利用可能なすべてのノードを一覧表示します。重要：ワークフローを作成または更新する前にこのツールを使用して、有効なノードタイプのみを使用していることを確認してください。これにより、現在のn8nインスタンスに存在しないノードタイプを使用することで発生するエラーを回避できます。
ワークフロー管理
list_workflows: n8nのすべてのワークフローを、ID、名前、ステータス、作成日、タグなどの基本情報とともに一覧表示します。結果は、アクティブステータス、タグ、または名前でフィルタリングできます。create_workflow: 指定されたノードと接続を使用して、n8n に新しいワークフローを作成します。作成されたワークフローを割り当てられた ID とともに返します。n8n インスタンスにすべてのノードタイプが存在することを検証します。get_workflow: すべてのノード、接続、設定、メタデータなど、特定のワークフローの ID による完全な詳細を取得します。update_workflow: 既存のワークフローを新しい設定で更新します。変更する部分だけでなく、ワークフロー全体の構造を指定する必要があります。n8nインスタンスにすべてのノードタイプが存在することを検証します。delete_workflow: ID で指定したワークフローを完全に削除します。このアクションは元に戻せません。activate_workflow: ID によってワークフローをアクティブ化し、トリガーに基づいて自動的に実行できるようにします。deactivate_workflow: ワークフローを ID で非アクティブ化し、自動的に実行されないようにします。
実行管理
list_executions: ワークフロー実行履歴を、成功/失敗ステータス、所要時間、タイムスタンプなどの詳細情報とともに一覧表示します。結果はワークフローID、ステータス、および特定の件数でフィルタリングできます。get_execution: 実行時間、ステータス、オプションで各ステップで処理された完全なデータなど、特定のワークフロー実行に関する詳細情報を取得します。
MCPリソース
n8n://workflows: n8n内のすべてのワークフローのリストn8n://workflows/{id}: 特定のn8nワークフローの詳細n8n://executions/{id}: 特定のn8nワークフロー実行の詳細
発達
設定
リポジトリをクローンする
依存関係をインストールします:
プロジェクトをビルドします。
開発モードで実行:
出版
このプロジェクトではバージョン管理に変更セットを使用しています。公開するには：
変更セットを作成します。
パッケージのバージョン:
npm に公開:
貢献
貢献を歓迎します！お気軽にプルリクエストを送信してください。
ライセンス
MIT ライセンス - 詳細についてはLICENSEファイルを参照してください。
謝辞
モデルコンテキストプロトコルに基づいて構築
n8nによって提供