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

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

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

要件

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

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

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

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

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

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

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

このコマンドは、 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の設定例:

利用可能な機能

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 ライセンスに基づいてライセンスされています。