mcp-n8n-ビルダー

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

特徴

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

構成

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

傾斜構成

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

{
	"mcpServers": {
		"n8n-workflow-builder": {
			"command": "npx",
			"args": ["-y", "mcp-n8n-builder"],
			"env": {
				"N8N_HOST": "http://localhost:5678/api/v1",
				"N8N_API_KEY": "your-n8n-api-key",
				"OUTPUT_VERBOSITY": "concise" // Options: 'concise' or 'full'
			}
		}
	}
}

WSL 構成の Claude デスクトップ

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

{
	"mcpServers": {
		"n8n-workflow-builder": {
			"command": "wsl.exe",
			"args": [
				"bash",
				"-c",
				"N8N_HOST=http://localhost:5678/api/v1 N8N_API_KEY=your-n8n-api-key OUTPUT_VERBOSITY=concise npx -y mcp-n8n-builder"
			]
		}
	}
}

環境変数

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

変数	説明	デフォルト
`N8N_HOST`	n8n APIのURL	`http://localhost:5678/api/v1`
`N8N_API_KEY`	n8n認証用のAPIキー	`""`
`SERVER_NAME`	MCPサーバーの名前	`"n8n-workflow-builder"`
`SERVER_VERSION`	MCP サーバーのバージョン	パッケージバージョン
`LOG_LEVEL`	ログレベル	`"info"`
`CACHE_ENABLED`	キャッシュを有効にする	`false`
`CACHE_TTL`	キャッシュTTL（秒）	`300`
`OUTPUT_VERBOSITY`	出力の詳細レベル（ `concise`または`full` ）	`"concise"`

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 install

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

npm run build

開発モードで実行:

npm run dev

出版

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

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

npm changeset

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

npm changeset version

npm に公開:

npm release

貢献

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

ライセンス

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

謝辞

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

mcp-n8n-builder

Integrations