Case Study RAG Workflow Automation With N8n And Gdrive MCP Server

🚀 使用 n8n 和 AI 代理通過模型上下文協議 (MCP) 與外部工具交互

本項目藉助 n8n 的 AI 代理功能，利用模型上下文協議（MCP）實現與外部工具的交互。通過動態發現和執行工具，如 Brave 搜索，為自動化工作流的構建提供了強大支持，極大提升了系統的靈活性。

🚀 快速開始

環境配置

啟動 Docker 容器

docker run -p 1234:1234 -e N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true -v n8n_data:/home/node/.n8n node8n GmbH/n8n

此命令啟動一個帶有以下配置的 Docker 容器：

• -p 1234:1234：將容器的 1234 端口映射到主機的 1234 端口。
• -e N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true：設置環境變量，允許社區包作為工具使用。
• -v n8n_data:/home/node/.n8n：掛載卷以持久化數據。

安裝依賴

確保已安裝以下工具：

• Docker
• Node.js（推薦版本 14 或更高）
• npm（推薦版本 6 或更高）

✨ 主要特性

• 動態工具調用：藉助 MCP 協議，AI 代理能夠動態發現和執行外部工具，如 Brave 搜索。
• 靈活的工作流：通過 n8n 的工作流配置，可根據用戶需求動態選擇和調用工具。
• 會話管理：配置內存模塊以保持會話歷史，為 AI 代理提供更準確的上下文信息。

💻 使用示例

工作流實現

工具發現與執行節點

MCP 客戶端 (列出工具)

{
  "type": "MCPClient",
  "operator": "listTools",
  "credentials": {
    "type": "MCPBraveSearch"
  }
}

此節點用於獲取可用工具的列表，包括工具名稱、描述和參數說明。

MCP 客戶端 (執行工具)

{
  "type": "MCPClient",
  "operator": "executeTool",
  "credentials": {
    "type": "MCPBraveSearch"
  },
  "toolName": "{{ $fromAI('tool', 'selected tool to execute') }}",
  "toolParameters": {
    "mode": "definedAutomaticallyByModel"
  }
}

此節點根據 AI 代理的決策執行具體工具操作。

工作流步驟

1. 接收聊天消息：通過 n8n 的聊天界面接收用戶輸入。
2. AI 代理：
   • 使用預設的對話模型（如 Groq 或 OpenAI）處理請求。
   • 配置內存模塊以保持會話歷史。
   • 設置系統提示，指導 AI 如何發現和使用工具。
3. 列出可用工具：AI 代理通過 MCP 客戶端獲取可執行工具的信息。
4. 執行選定工具：根據用戶需求，動態選擇並調用相應工具（如 Brave 網頁搜索）。

實驗與測試

1. 啟用工作流後，在 n8n 的聊天界面輸入以下內容：
   • What tools do you have? 或 list available tools
     • AI 代理將返回可用的工具列表及其功能說明。
   • Tell me about the latest developments in the Model Context Protocol.
     • AI 代理將調用 Brave 搜索工具，獲取並返回相關信息。

🔧 技術細節

模型上下文協議 (MCP)

MCP 是一種用於發現和執行外部工具的協議。通過 MCP 客戶端節點，AI 代理可以與外部工具進行交互，獲取工具列表並執行具體操作。

AI 代理

AI 代理使用預設的對話模型（如 Groq 或 OpenAI）處理用戶請求。通過配置內存模塊和系統提示，AI 代理能夠更好地理解用戶意圖，並動態選擇和調用合適的工具。

📚 詳細文檔

常見問題排查

環境變量配置錯誤

• 現象：無法執行社區包中的工具。
• 原因：未設置或誤設 N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE 環境變量。
• 解決方法：在啟動容器時，確保正確傳遞此環境變量。

工具發現失敗

• 現象：無法獲取工具列表。
• 原因：MCP 客戶端節點配置錯誤或 credentials 屬性未正確設置。
• 解決方法：檢查 MCP 客戶端節點的配置，確保其使用正確的憑據類型（如 MCPBraveSearch）。

工具執行失敗

• 現象：調用工具時出現錯誤。
• 原因：toolName 參數未正確傳遞或 toolParameters 模式設置不當。
• 解決方法：
  • 確保 toolName 動態表達式準確無誤。
  • 根據需要設置 toolParameters 的模式（如 definedAutomaticallyByModel 或手動指定參數）。

總結

通過本文檔，您成功設置了基於 n8n 的 AI 工具鏈，能夠動態發現和調用外部工具。這種方法不僅提升了系統的靈活性，還為自動化工作流的構建提供了強大支持。