N8n Workflow Builder

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

このプロジェクトは、n8n ワークフローを管理するための MCP サーバを提供します。ワークフローの一覧表示、作成、更新、削除、アクティブ化、非アクティブ化などの機能を備えています。

⚠️ 重要な注意事項

このバージョンでは、パッケージ管理とサーバの実行に npm の使用のみがサポートされています。（将来のバージョンで npx のサポートが再導入されます。）

🚀 クイックスタート

このセクションでは、n8n ワークフロービルダ MCP サーバをすばやくセットアップする手順を説明します。

📦 インストール

前提条件

• Node.js (推奨 v14+)
• npm

インストール手順

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 のサポートを再導入する。
• より多くのワークフロー機能を追加する。
• サーバのパフォーマンスと安定性を向上させる。

📄 ライセンス

[ここにライセンス情報を挿入]

貢献者

[ここに貢献者を記載]

リンク

[ここに関連リンクを追加]