N8n Workflow Builder

🚀 n8n 工作流構建器 MCP 服務器

該項目提供了一個 MCP 服務器，用於管理 n8n 工作流。它具備列出、創建、更新、刪除、激活和停用工作流等功能，為 n8n 工作流的管理提供了便利。

🚀 快速開始

此項目提供的 MCP 服務器可對 n8n 工作流進行管理。不過要注意，此版本僅支持使用 npm 進行包管理和運行服務器，未來版本會重新引入對 npx 的支持。

✨ 主要特性

• 工作流管理功能豐富：提供了列出、創建、更新、刪除、激活和停用工作流的功能。
• 資源訪問高效：提供了靜態資源和動態資源模板，方便更高效地進行上下文訪問。

📦 安裝指南

先決條件

• 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": []
  }
}

💻 使用示例

基礎用法

以下是啟動服務器的基本命令：

npm start

高級用法

當遇到問題時，可使用以下命令清理構建目錄並重新構建：

npm run clean && npm run build

📚 詳細文檔

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}：特定執行的詳細信息

🔧 技術細節

此服務器通過 stdio 連接啟動，使用 npm 進行包管理和運行。服務器配置通過 cline_mcp_settings.json 文件管理，需要確保 N8N_HOST 和 N8N_API_KEY 等環境變量正確設置。

📄 許可證

[此處插入許可證信息]

貢獻者

[此處列出貢獻者]

鏈接

[此處添加相關鏈接]

⚠️ 重要提示

此版本僅支持使用 npm 進行包管理和運行服務器（未來版本將重新引入對 npx 的支持）。

💡 使用建議

• 若遇到任何問題，請清理構建目錄並重新構建：npm run clean && npm run build。
• 要驗證 cline_mcp_settings.json 中的環境變量是否正確。