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

概要

このプロジェクトは、AIアシスタントが人気のワークフロー自動化ツールn8nとシームレスに連携できるようにするモデルコンテキストプロトコル(MCP)サーバーを提供します。これは架け橋として機能し、AIアシスタントが自然言語コマンドを使ってn8nのワークフローや実行をプログラム的に管理・制御できるようにします。

設置

前提条件

• Node.js 20歳以上
• APIアクセスが有効なn8nインスタンス

npmからインストール

ソースからインストール

Docker インストール

サーバーはDockerを使っても動かせます:

サーバーの更新中

サーバーの更新方法は、最初にどのようにインストールするかによります。

1.npm経由でグローバルにインストール

[T0]]でサーバーをインストールした場合:

1. 端末またはコマンドプロンプトを開く。

2. 最新バージョンを取得するには以下のコマンドを実行します:

3. サーバーが現在稼働中(例:バックグラウンドプロセスやサービスとして)場合、変更が適用されるために再起動が必要です。

2.ソースからインストール

リポジトリをクローンしてソースからインストールした場合:

n8n MCP Server

A Model Context Protocol (MCP) server that allows AI assistants to interact with n8n workflows through natural language.

Overview

This project provides a Model Context Protocol (MCP) server that empowers AI assistants to seamlessly interact with n8n, a popular workflow automation tool. It acts as a bridge, enabling AI assistants to programmatically manage and control n8n workflows and executions using natural language commands.

Installation

Prerequisites

• Node.js 20 or later
• n8n instance with API access enabled

Install from npm

npm install -g @leonardsellem/n8n-mcp-server

Install from source

# 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 Installation

You can also run the server using 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

Updating the Server

How you update the server depends on how you initially installed it.

1. Installed globally via npm

If you installed the server using npm install -g @leonardsellem/n8n-mcp-server:

1. Open your terminal or command prompt.
2. Run the following command to get the latest version:

   npm install -g @leonardsellem/n8n-mcp-server@latest
   

3. If the server is currently running (e.g., as a background process or service), you’ll need to restart it for the changes to take effect.

2. Installed from source

If you cloned the repository and installed from source:

1. Open your terminal or command prompt.
2. Navigate to the directory where you cloned the project:

   cd path/to/n8n-mcp-server
   

3. If you’ve made any local changes to the code that you want to keep, consider stashing them (optional):

   git stash
   

   You can apply them later with git stash pop.
4. Pull the latest changes from the repository (assuming you are on the main branch):

   git pull origin main
   

   If you are on a different branch, replace main with your branch name.
5. Install or update any changed dependencies:

   npm install
   

6. Rebuild the project to include the latest updates:

   npm run build
   

7. If you previously installed it globally from this source folder using npm install -g ., you might want to run this command again to update the global link:

   npm install -g .
   

8. Restart the server.