n8n ワークフロービルダー MCP サーバー

このプロジェクトは、n8nワークフローを管理するためのMCPサーバーを提供します。定義されたツールセットを通じて、ワークフローの一覧表示、作成、更新、削除、有効化、無効化などの機能を提供します。

重要：
このバージョンでは、パッケージ管理とサーバーの実行にnpmのみをサポートしています。(npx サポートは将来のアップデートで再導入される予定です。)

要件

• Node.js (v14以上を推奨)

• npm

Related MCP server: n8n MCP Server

詳細なインストールガイド

1. リポジトリのクローンを作成する

好みのソースからリポジトリをクローンします。例:

git clone https://github.com/makafeli/n8n-workflow-builder.git

次に、プロジェクト ディレクトリに移動します。

cd /root/n8n-workflow-builder

2. 依存関係をインストールする

npm を使用して必要な依存関係をインストールします。

npm install

このコマンドは、 package.jsonファイルに定義されているすべての必要なパッケージをダウンロードしてインストールします。

3. ビルドとテスト

サーバーをテストしてオンラインにするには、次のコマンドを使用します。

• プロジェクトをビルドします。
  これにより、TypeScript ファイルがコンパイルされ、 buildディレクトリに実行可能な JavaScript が生成されます。

  npm run build

• MCP サーバーを起動します。
  次を使用してサーバーを起動します。

  npm start

サーバーが起動し、stdio経由で接続します。コンソールにサーバーが正常に起動したことを示すメッセージが表示されます。

4. 展開

テスト目的やサーバーをオンラインにするには、上記のビルドおよび起動コマンドを使用してください。この基本的なワークフロー（インストール、ビルド、起動）が現在推奨されている方法です。

5. 追加設定

サーバー設定はcline_mcp_settings.jsonファイルで管理されます。以下の環境変数が正しく設定されていることを確認してください。

• N8N_HOST : n8n API ホスト URL。

• N8N_API_KEY : n8n API キー。

cline_mcp_settings.jsonの設定例:

{
  "n8n-workflow-builder": {
    "command": "node",
    "args": ["/root/n8n-workflow-builder/build/index.js"],
    "env": {
      "N8N_HOST": "https://n8n.io/api/v1/",
      "N8N_API_KEY": "YOUR_N8N_API_KEY_HERE"
    },
    "disabled": false,
    "alwaysAllow": [
      "create_workflow",
      "create_workflow_and_activate",
      "update_workflow",
      "activate_workflow",
      "deactivate_workflow",
      "get_workflow",
      "delete_workflow"
    ],
    "autoApprove": []
  }
}

利用可能な機能

MCPツール

次のツールはサーバーで定義されており、MCP クライアントを通じてアクセスできます。

ワークフロー管理

• list_workflows : n8n からのすべてのワークフローを一覧表示します。

• create_workflow : n8n に新しいワークフローを作成します。

• get_workflow : ID でワークフローを取得します。

• update_workflow : 既存のワークフローを更新します。

• delete_workflow : ID でワークフローを削除します。

• activate_workflow : ID でワークフローをアクティブ化します。

• deactivate_workflow : ID によってワークフローを非アクティブ化します。

実行管理

• list_executions : オプションのフィルターを使用してすべてのワークフロー実行を一覧表示します。

• get_execution : ID によって特定の実行の詳細を取得します。

• delete_execution : ID によって実行を削除します。

MCPリソース

サーバーは、より効率的なコンテキスト アクセスを実現するために、次のリソースも提供します。

静的リソース

• /workflows : n8nインスタンスで利用可能なすべてのワークフローのリスト

• /execution-stats : ワークフロー実行に関する概要統計

動的リソーステンプレート

• /workflows/{id} : 特定のワークフローに関する詳細情報

• /executions/{id} : 特定の実行に関する詳細情報

トラブルシューティング

• npm を使用していることを確認してください (このバージョンは npx をサポートしていません)。

• 問題が発生した場合は、ビルド ディレクトリをクリーンアップして再構築してみてください。

  npm run clean && npm run build

• cline_mcp_settings.json内の環境変数が正しいことを確認します。

将来の機能強化

• npx サポートの再導入。

• 追加のツールとワークフロー機能。

• 展開とスケーリングのさらなる強化。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています。