n8n MCP サーバー

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

概要

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

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

Related MCP server: MCP Server for n8n Integration

インストール

前提条件

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