n8n MCP サーバー

Name: n8n MCP Server
Author: leonardsellem

AI アシスタントが自然言語を通じて n8n ワークフローと対話できるようにするモデルコンテキストプロトコル (MCP) サーバー。

概要

このMCPサーバーは、AIアシスタントがn8nのワークフローと実行を管理するためのツールとリソースを提供します。アシスタントは以下のことが可能になります。

ワークフローの一覧表示、作成、更新、削除
ワークフローを有効化および無効化する
ワークフローを実行し、そのステータスを監視する
ワークフロー情報と実行統計にアクセスする

Related MCP server: MCP Toolkit

インストール

前提条件

Node.js 18以降
APIアクセスが有効になっているn8nインスタンス

npmからインストール

npm install -g n8n-mcp-server

ソースからインストール

# Clone the repository git clone https://github.com/leonardsellem/n8n-mcp-server.git cd n8n-mcp-server # Install dependencies npm install # Build the project npm run build # Optional: Install globally npm install -g .

Dockerのインストール

Docker を使用してサーバーを実行することもできます。

# Pull the image docker pull leonardsellem/n8n-mcp-server # Run the container with your n8n API configuration docker run -e N8N_API_URL=http://your-n8n:5678/api/v1 \ -e N8N_API_KEY=your_n8n_api_key \ -e N8N_WEBHOOK_USERNAME=username \ -e N8N_WEBHOOK_PASSWORD=password \ leonardsellem/n8n-mcp-server

構成

.env.exampleテンプレートとして使用して、サーバーを実行するディレクトリに.envファイルを作成します。

cp .env.example .env

次の環境変数を設定します。

変数	説明	例
`N8N_API_URL`	`/api/v1` を含む n8n API の完全な URL	`http://localhost:5678/api/v1`
`N8N_API_KEY`	n8nで認証するためのAPIキー	`n8n_api_...`
`N8N_WEBHOOK_USERNAME`	Webhook 認証のユーザー名 (Webhook を使用している場合)	`username`
`N8N_WEBHOOK_PASSWORD`	Webhook認証用のパスワード	`password`
`DEBUG`	デバッグログを有効にする（オプション）	`true` か `false`

n8n APIキーの生成

ブラウザでn8nインスタンスを開く
設定 > API > APIキーに移動します
適切な権限を持つ新しいAPIキーを作成する
キーを.envファイルにコピーします

使用法

サーバーの実行

インストールディレクトリから:

n8n-mcp-server

またはグローバルにインストールされている場合:

n8n-mcp-server

AIアシスタントとの統合

サーバーをビルド（ npm run build ）した後、AIアシスタント（Claude拡張機能付きのVS CodeやClaudeデスクトップアプリなど）を実行して動作させるには、設定が必要です。通常はJSON設定ファイルを編集する必要があります。

構成例 (例: VS Code の

{ "mcpServers": { // Give your server a unique name "n8n-local": { // Use 'node' to execute the built JavaScript file "command": "node", // Provide the *absolute path* to the built index.js file "args": [ "/path/to/your/cloned/n8n-mcp-server/build/index.js" // On Windows, use double backslashes: // "C:\\path\\to\\your\\cloned\\n8n-mcp-server\\build\\index.js" ], // Environment variables needed by the server "env": { "N8N_API_URL": "http://your-n8n-instance:5678/api/v1", // Replace with your n8n URL "N8N_API_KEY": "YOUR_N8N_API_KEY", // Replace with your key // Add webhook credentials only if you plan to use webhook tools // "N8N_WEBHOOK_USERNAME": "your_webhook_user", // "N8N_WEBHOOK_PASSWORD": "your_webhook_password" }, // Ensure the server is enabled "disabled": false, // Default autoApprove settings "autoApprove": [] } // ... other servers might be configured here } }

要点:

/path/to/your/cloned/n8n-mcp-server/リポジトリをクローンして構築した実際の絶対パスに置き換えます。
オペレーティングシステムに適したパス区切り文字を使用します (macOS/Linux の場合はスラッシュ/ 、Windows の場合は二重のバックスラッシュ\\ )。
正しいN8N_API_URL ( /api/v1を含む) とN8N_API_KEYを指定していることを確認してください。
アシスタントがbuild/index.jsファイルを実行する前に、サーバーをビルドする必要があります ( npm run build )。

利用可能なツール

サーバーは次のツールを提供します。

Webhookの使用

このMCPサーバーは、n8nウェブフックを介したワークフローの実行をサポートしています。この機能を使用するには、以下の手順を実行してください。

n8n で Webhook トリガーのワークフローを作成します。
Webhook ノードに基本認証を設定します。
ワークフロー名のみを渡して、 run_webhookツールを使用してワークフローをトリガーします。

例：

const result = await useRunWebhook({ workflowName: "hello-world", // Will call <n8n-url>/webhook/hello-world data: { prompt: "Hello from AI assistant!" } });

Webhook 認証は、 N8N_WEBHOOK_USERNAMEおよびN8N_WEBHOOK_PASSWORD環境変数を使用して自動的に処理されます。

ワークフロー管理

workflow_list : すべてのワークフローを一覧表示する
workflow_get : 特定のワークフローの詳細を取得する
workflow_create : 新しいワークフローを作成する
workflow_update : 既存のワークフローを更新する
workflow_delete : ワークフローを削除する
workflow_activate : ワークフローをアクティブ化する
workflow_deactivate : ワークフローを非アクティブ化する

実行管理

execution_run : API経由でワークフローを実行する
run_webhook : Webhook経由でワークフローを実行する
execution_get : 特定の実行の詳細を取得する
execution_list : ワークフローの実行を一覧表示する
execution_stop : 実行中の実行を停止する

リソース

サーバーは次のリソースを提供します。

n8n://workflows/list : すべてのワークフローのリスト
n8n://workflow/{id} : 特定のワークフローの詳細
n8n://executions/{workflowId} : ワークフローの実行リスト
n8n://execution/{id} : 特定の実行の詳細

発達

建物

npm run build

開発モードで実行

npm run dev

テスト

npm test

リンティング

npm run lint

ライセンス

マサチューセッツ工科大学

n8n MCP Server