SM

spences10/mcp-n8n-builder

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

86 stars 24 forks 品質 86 トレンド 28MIT

spences10/mcp-n8n-builder は [https://github.com/spences10/mcp-n8n-builder. からインポートされた MCP サーバーの候補です

概要

spences10/mcp-n8n-builder は [https://github.com/spences10/mcp-n8n-builder. からインポートされた MCP サーバーの候補です

概要(AI 翻訳)

プログラマティック作成のためのモデルコンテキストプロトコル(MCP)サーバー n8nワークフローの管理 このサーバーは、ツールとリソースを提供します n8n の REST API とやりとりするため、AI アシスタントがビルドできるようにします。 ダイレクトユーザの介入なしにワークフローを変更、管理します。

##特徴

  • 業務フロー管理**: 作成、読み込み、更新、削除、有効化、 ワークフローの非アクティブ化
  • 業務執行管理**: ワークフローの実行リストと取得 ニュース
  • ✅Schema Validation: Zod による包括的な検証 入力および出力データ
  • ANSI ノードの検証: n8n のノードタイプを有効化 ワークフロー作成前のノードでエラーを防ぐ
  • 3.8 スマート提案: 類似ノードの提案を提供 無効なノードが検出されるときのタイプ
  • ✓ エラー処理*: トラブルシューティングのための詳細なエラーメッセージ
  • ドキュメント**: すべてのツールとツールの広範なドキュメント リソース
  • ZendSearch & Filter: 名前、タグ、またはアクティブでワークフローをフィルタリングする ステータス

⚠️ トークン消費警告

このツールは、n8nワークフローの性質による「トークンモンスター」です

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

mcp-n8n-builder

A Model Context Protocol (MCP) server for programmatic creation and management of n8n workflows. This server provides tools and resources for interacting with n8n’s REST API, allowing AI assistants to build, modify, and manage workflows without direct user intervention.

Features

  • 🔄 Workflow Management: Create, read, update, delete, activate, and deactivate workflows
  • 📊 Execution Management: List and retrieve workflow execution details
  • ✅ Schema Validation: Comprehensive validation with Zod for both input and output data
  • 🔍 Node Validation: Validates node types against n8n’s available nodes before workflow creation to prevent errors
  • 🤔 Smart Suggestions: Provides suggestions for similar node types when invalid nodes are detected
  • 🛠️ Error Handling: Detailed error messages for troubleshooting
  • 📝 Documentation: Extensive documentation for all tools and resources
  • 🔍 Search & Filter: Filter workflows by name, tags, or active status

⚠️ Token Consumption Warning

This tool is a “token monster” due to the nature of n8n workflows:

  • N8N workflows are complex JSON structures with nested nodes, connections, parameters, and settings
  • A single workflow can easily consume thousands of tokens when viewed or edited
  • The JSON structure cannot be meaningfully reduced without losing essential workflow information
  • LLM context windows are finite - complex workflows may exceed available context

Mitigation Strategies

The tool implements several optimizations to reduce token usage:

  • Verbosity Control: Use OUTPUT_VERBOSITY=concise (default) for summaries instead of full JSON
  • Object Simplification: Workflow listings show only essential fields (id, name, status, node count)
  • Selective Guide Inclusion: Error messages include only relevant sections of the composition guide
  • Per-tool Verbosity: Override verbosity on individual tool calls with the verbosity parameter
  • List workflows first to identify what you need (low token cost)
  • Work with simple workflows when possible
  • Use concise verbosity unless you specifically need full JSON
  • Break complex workflows into smaller pieces for easier management
  • Consider the token cost before retrieving or editing large workflows

Configuration

This server requires configuration through your MCP client. Here are examples for different environments:

Cline Configuration

Add this to your Cline MCP settings:

{
	"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",
GitHub で README 全文を見る

インストール

npx -y mcp-n8n-builder
MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

{ "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' } } } }