n8n ワークフロービルダー MCP サーバー
このプロジェクトは、n8nワークフローを管理するためのMCPサーバーを提供します。定義されたツールセットを通じて、ワークフローの一覧表示、作成、更新、削除、有効化、無効化などの機能を提供します。
重要：
このバージョンでは、パッケージ管理とサーバーの実行にnpmのみをサポートしています。(npx サポートは将来のアップデートで再導入される予定です。)
要件
Node.js (v14以上を推奨)
npm
Related MCP server: n8n MCP Server
詳細なインストールガイド
1. リポジトリのクローンを作成する
好みのソースからリポジトリをクローンします。例:
次に、プロジェクト ディレクトリに移動します。
2. 依存関係をインストールする
npm を使用して必要な依存関係をインストールします。
このコマンドは、 package.jsonファイルに定義されているすべての必要なパッケージをダウンロードしてインストールします。
3. ビルドとテスト
サーバーをテストしてオンラインにするには、次のコマンドを使用します。
プロジェクトをビルドします。
これにより、TypeScript ファイルがコンパイルされ、buildディレクトリに実行可能な JavaScript が生成されます。npm run buildMCP サーバーを起動します。
次を使用してサーバーを起動します。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 buildcline_mcp_settings.json内の環境変数が正しいことを確認します。
将来の機能強化
npx サポートの再導入。
追加のツールとワークフロー機能。
展開とスケーリングのさらなる強化。
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています。