momentry_core/docs/N8N_MCP_TEST_REPORT.md

n8n MCP 整合測試報告

測試日期

2026-03-23

測試環境

• n8n Version: 2.3.5
• n8n URL: http://localhost:5678
• MCP Server: @nextoolsolutions/mcp-n8n v2.0.0
• OpenCode Config: ~/.config/opencode/opencode.json

測試結果

✅ 所有測試通過

測試項目	狀態	詳細說明
MCP 伺服器初始化	✅ 通過	Protocol version 2024-11-05
工具列表載入	✅ 通過	43 個工具可用
工具呼叫 (list_workflows)	✅ 通過	成功返回 5 個 workflows
API 連線	✅ 通過	http://localhost:5678

可用工具 (43 個)

Workflows (10)

• n8n_list_workflows - 列出所有工作流程
• n8n_get_workflow - 取得工作流程詳情
• n8n_create_workflow - 建立新工作流程
• n8n_update_workflow - 更新工作流程
• n8n_delete_workflow - 刪除工作流程
• n8n_activate_workflow - 啟動工作流程
• n8n_deactivate_workflow - 停止工作流程
• n8n_execute_workflow - 執行工作流程
• n8n_get_workflow_tags - 取得工作流程標籤
• n8n_update_workflow_tags - 更新工作流程標籤

Executions (3)

• n8n_list_executions - 列出執行記錄
• n8n_get_execution - 取得執行詳情
• n8n_delete_execution - 刪除執行記錄

Data Tables (6)

• n8n_list_datatables - 列出資料表
• n8n_create_datatable - 建立資料表
• n8n_get_datatable - 取得資料表
• n8n_get_datatable_rows - 查詢資料表資料
• n8n_insert_datatable_rows - 插入資料
• n8n_update_datatable_rows - 更新資料
• n8n_upsert_datatable_row - 更新或插入
• n8n_delete_datatable_rows - 刪除資料

Tags (5)

• n8n_list_tags - 列出標籤
• n8n_get_tag - 取得標籤
• n8n_create_tag - 建立標籤
• n8n_update_tag - 更新標籤
• n8n_delete_tag - 刪除標籤

Credentials (4)

• n8n_list_credentials - 列出認證
• n8n_create_credential - 建立認證
• n8n_delete_credential - 刪除認證
• n8n_get_credential_schema - 取得認證結構

Users (3)

• n8n_list_users - 列出使用者
• n8n_get_user - 取得使用者
• n8n_delete_user - 刪除使用者

Variables (3)

• n8n_list_variables - 列出變數
• n8n_create_variable - 建立變數
• n8n_delete_variable - 刪除變數

Projects (4)

• n8n_list_projects - 列出專案
• n8n_create_project - 建立專案
• n8n_update_project - 更新專案
• n8n_delete_project - 刪除專案

System (3)

• n8n_generate_audit - 產生安全稽核報告
• n8n_health_check - 健康檢查
• n8n_trigger_webhook - 觸發 Webhook

配置檔案

~/.config/opencode/opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "gitea": {
      "type": "local",
      "enabled": true,
      "command": [
        "/opt/homebrew/bin/gitea-mcp-server",
        "-token", "<GITEA_TOKEN>",
        "-host", "http://localhost:3000"
      ]
    },
    "n8n": {
      "type": "local",
      "enabled": true,
      "command": ["/opt/homebrew/bin/mcp-n8n"],
      "environment": {
        "N8N_BASE_URL": "http://localhost:5678",
        "N8N_API_KEY": "<N8N_API_KEY>"
      }
    }
  }
}

測試範例

列出工作流程

# 使用 curl
curl -H "X-N8N-API-KEY: <API_KEY>" http://localhost:5678/api/v1/workflows

# 使用 MCP
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"n8n_list_workflows","arguments":{"limit":5}}}' | mcp-n8n

建立工作流程

# 使用 curl
curl -X POST \
  -H "Content-Type: application/json" \
  -H "X-N8N-API-KEY: <API_KEY>" \
  -d '{"name":"My Workflow","nodes":[],"connections":{}}' \
  http://localhost:5678/api/v1/workflows

# 使用 MCP
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"n8n_create_workflow","arguments":{"workflow":{"name":"My Workflow","nodes":[],"connections":{}}}}' | mcp-n8n

現有工作流程 (範例)

測試中成功讀取的工作流程：

1. Diagnostic: Environment Test (ID: 4vaf6dKznkTccuyC)

   • 狀態: Active
   • 用途: 環境測試與時間同步驗證

2. Simple Test Webhook v2 (ID: 38bbM14sGo0eVCuW)

   • 狀態: Active
   • 用途: Webhook 測試

3. HL Chat Searching - RAG Only (ID: 6Y9c7mGtye4DjuENR5Kbg)

   • 狀態: Inactive
   • 用途: RAG 聊天搜尋整合

4. HL Embedding with AccusysDB (ID: 61nRs3BeNGlBtuYJFLSFn)

   • 狀態: Inactive
   • 用途: Qdrant 向量資料庫嵌入

5. HL Embedding with AccusysDB (local) (ID: 017oYPE7cDpvybAn)

   • 狀態: Archived
   • 用途: 本地測試版本

結論

✅ n8n MCP 整合測試全部通過！

MCP 伺服器已成功配置並運作，可以透過 OpenCode 使用所有 43 個 n8n 管理工具。

建議用途

1. 自動化工作流程管理 - 使用 AI 協助建立、修改、監控工作流程
2. 批次執行 - 透過 MCP 批量管理工作流程
3. 監控與稽核 - 自動化執行記錄檢視與安全稽核
4. 整合測試 - 與 Momentry Core Video RAG 整合測試

下一步

• 使用 OpenCode 建立 Video RAG 整合工作流程
• 設定自動化監控與告警
• 建立工作流程模板庫