mcp-n8n-builder

mcp-n8n-ビルダー

n8nワークフローをプログラム的に作成・管理するためのモデルコンテキストプロトコル（MCP）サーバー。このサーバーは、n8nのREST APIと連携するためのツールとリソースを提供し、AIアシスタントがユーザーの直接的な介入なしにワークフローを構築、変更、管理できるようにします。

特徴

• 🔄ワークフロー管理：ワークフローの作成、読み取り、更新、削除、有効化、無効化
• 📊実行管理：ワークフロー実行の詳細を一覧表示および取得する
• ✅スキーマ検証: 入力データと出力データの両方に対して Zod による包括的な検証
• 🔍ノード検証: ワークフロー作成前に、エラーを防ぐために n8n の利用可能なノードに対してノードタイプを検証します。
• 🤔スマートサジェスチョン: 無効なノードが検出された場合、類似のノードタイプの提案を提供します
• 🛠️エラー処理: トラブルシューティングのための詳細なエラーメッセージ
• 📝ドキュメント: すべてのツールとリソースに関する詳細なドキュメント
• 🔍検索とフィルター: 名前、タグ、アクティブステータスでワークフローをフィルターします

構成

このサーバーはMCPクライアント経由で設定する必要があります。以下に、様々な環境における設定例を示します。

傾斜構成

Cline MCP 設定に以下を追加します:

WSL 構成の Claude デスクトップ

WSL 環境の場合は、Claude Desktop 構成に以下を追加します。

環境変数

サーバーは環境変数を使用して設定できます。

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ワークフロー実行の詳細

発達

設定

1. リポジトリをクローンする
2. 依存関係をインストールします:

3. プロジェクトをビルドします。

4. 開発モードで実行:

出版

このプロジェクトではバージョン管理に変更セットを使用しています。公開するには：

1. 変更セットを作成します。

2. パッケージのバージョン:

3. npm に公開:

貢献

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

ライセンス

MIT ライセンス - 詳細についてはLICENSEファイルを参照してください。

謝辞

• モデルコンテキストプロトコルに基づいて構築
• n8nによって提供