[ PROMPT_NODE_28116 ]
n8n-mcp-tools-expert
[ SKILL_DOCUMENTATION ]
# n8n MCP 工具专家
使用 n8n-mcp 服务器工具构建工作流的权威指南。
---
## 工具分类
n8n-mcp 提供 **40+ 种工具**,分为以下几类:
1. **节点发现** → [SEARCH_GUIDE.md](SEARCH_GUIDE.md)
2. **配置验证** → [VALIDATION_GUIDE.md](VALIDATION_GUIDE.md)
3. **工作流管理** → [WORKFLOW_GUIDE.md](WORKFLOW_GUIDE.md)
4. **模板库** - 搜索并访问 2,653 个真实工作流
5. **文档** - 获取工具和节点文档
---
## 快速参考
### 最常用工具 (按成功率排序)
| 工具 | 使用场景 | 成功率 | 速度 |
|------|----------|--------------|-------|
| `search_nodes` | 按关键词查找节点 | 99.9% | <20ms |
| `get_node_essentials` | 理解节点操作 | 91.7% | <10ms |
| `validate_node_operation` | 检查配置 | 不定 | <100ms |
| `n8n_create_workflow` | 创建工作流 | 96.8% | 100-500ms |
| `n8n_update_partial_workflow` | 编辑工作流 (最常用!) | 99.0% | 50-200ms |
| `validate_workflow` | 检查完整工作流 | 95.5% | 100-500ms |
---
## 工具选择指南
### 查找正确的节点
**工作流**:
1. search_nodes({query: "keyword"})
2. get_node_essentials({nodeType: "nodes-base.name"})
3. [可选] get_node_documentation({nodeType: "nodes-base.name"})
**示例**:
javascript
// 第 1 步: 搜索
search_nodes({query: "slack"})
// 返回: nodes-base.slack
// 第 2 步: 获取详情 (步骤间平均耗时 18s)
get_node_essentials({nodeType: "nodes-base.slack"})
// 返回: 操作、属性、示例
**常用模式**: 搜索 → 获取核心信息 (平均 18s)
### 验证配置
**工作流**:
1. validate_node_minimal({nodeType, config: {}}) - 检查必填字段
2. validate_node_operation({nodeType, config, profile: "runtime"}) - 全面验证
3. [重复] 修复错误,再次验证
**常用模式**: 验证 → 修复 → 验证 (每个周期 23s 思考,58s 修复)
### 管理工作流
**工作流**:
1. n8n_create_workflow({name, nodes, connections})
2. n8n_validate_workflow({id})
3. n8n_update_partial_workflow({id, operations: [...]})
4. n8n_validate_workflow({id}) 再次验证
**常用模式**: 迭代更新 (编辑间平均 56s)
---
## 关键点: nodeType 格式
针对不同工具使用 **两种不同格式**!
### 格式 1: 搜索/验证工具
javascript
// 使用短前缀
"nodes-base.slack"
"nodes-base.httpRequest"
"nodes-base.webhook"
"nodes-langchain.age"