Leonardsellem N8n MCP Server

🚀 n8n MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）を用いて、AI アシスタントが自然言語で n8n ワークフローとやり取りできるようにするものです。

🚀 クイックスタート

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

• ワークフローの一覧表示、作成、更新、削除
• ワークフローの有効化と無効化
• ワークフローの実行と状態の監視
• ワークフロー情報と実行統計の取得

✨ 主な機能

• AI アシスタントが自然言語で n8n ワークフローとやり取りできる。
• ワークフローの管理と実行の制御が容易に行える。

📦 インストール

前提条件

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

npm からのインストール

npm install -g n8n-mcp-server

ソースコードからのインストール

# リポジトリをクローン
git clone https://github.com/leonardsellem/n8n-mcp-server.git
cd n8n-mcp-server

# 依存関係をインストール
npm install

# プロジェクトをビルド
npm run build

# オプション：グローバルにインストール
npm install -g .

📚 ドキュメント

設定

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

cp .env.example .env

以下の環境変数を設定します：

n8n API キーの生成

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

使用方法

サーバーの起動

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

n8n-mcp-server

またはグローバルにインストールした場合：

n8n-mcp-server

AI アシスタントとの統合

この MCP サーバーを AI アシスタントプラットフォームに登録する方法は、使用するプラットフォームによって異なります。例えば、MCP インストーラーを使用する場合：

npx @anaisbetts/mcp-installer

その後、サーバーを登録します：

install_local_mcp_server path/to/n8n-mcp-server

利用可能なツール

サーバーは以下のツールを提供します：

ワークフロー管理

• workflow_list：すべてのワークフローを一覧表示します。
• workflow_get：特定のワークフローの詳細情報を取得します。
• workflow_create：新しいワークフローを作成します。
• workflow_update：既存のワークフローを更新します。
• workflow_delete：ワークフローを削除します。
• workflow_activate：ワークフローを有効化します。
• workflow_deactivate：ワークフローを無効化します。

実行管理

• execution_run：ワークフローを実行します。
• 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

📄 ライセンス

MIT