feat: Initial v0.9 release with API Key authentication
## v0.9.20260325_144654 ### Features - API Key Authentication System - Job Worker System - V2 Backup Versioning ### Bug Fixes - get_processor_results_by_job column mapping Co-authored-by: OpenCode
This commit is contained in:
accusys
178
docs/N8N_MCP_TEST_REPORT.md
Normal file
178
docs/N8N_MCP_TEST_REPORT.md
Normal file
@@ -0,0 +1,178 @@
|
||||
# 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
|
||||
```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>"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 測試範例
|
||||
|
||||
### 列出工作流程
|
||||
```bash
|
||||
# 使用 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
|
||||
```
|
||||
|
||||
### 建立工作流程
|
||||
```bash
|
||||
# 使用 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 整合工作流程
|
||||
- 設定自動化監控與告警
|
||||
- 建立工作流程模板庫
|
||||
Reference in New Issue
Block a user