Files
n8n-mcp/src/scripts
czlonkowski cb224de01f feat: add canonical AI tool examples for search_nodes includeExamples
Phase 3 Complete: AI Examples Extraction and Enhancement

Created canonical examples for 4 critical AI tools that were missing from
the template database. These hand-crafted examples demonstrate best practices
from FINAL_AI_VALIDATION_SPEC.md and are now available via includeExamples parameter.

New Files:
1. **src/data/canonical-ai-tool-examples.json** (11 examples)
   - HTTP Request Tool: 3 examples (Weather API, GitHub Issues, Slack)
   - Code Tool: 3 examples (Shipping calc, Data formatting, Date parsing)
   - AI Agent Tool: 2 examples (Research specialist, Data analyst)
   - MCP Client Tool: 3 examples (Filesystem, Puppeteer, Database)

2. **src/scripts/seed-canonical-ai-examples.ts**
   - Automated seeding script for canonical examples
   - Creates placeholder template (ID: -1000) for foreign key constraint
   - Properly tracks complexity, credentials, and expressions
   - Logs seeding progress with detailed metadata

Example Features:
- All examples follow validation spec requirements
- Include proper toolDescription/description fields
- Demonstrate credential configuration
- Show n8n expression usage
- Cover simple, medium, and complex use cases
- Provide real-world context and use cases

Database Impact:
- Before: 197 node configs from 10 templates
- After: 208 node configs (11 canonical + 197 template)
- Critical gaps filled for most-used AI tools

Usage:
```typescript
// Via search_nodes
search_nodes({query: "HTTP Request Tool", includeExamples: true})

// Via get_node_essentials
get_node_essentials({
  nodeType: "nodes-langchain.toolCode",
  includeExamples: true
})
```

Benefits:
- Users get immediate working examples for AI tools
- Examples demonstrate validation best practices
- Reduces trial-and-error in AI workflow construction
- Provides templates for common AI integration patterns

Files Changed:
- src/data/canonical-ai-tool-examples.json (NEW)
- src/scripts/seed-canonical-ai-examples.ts (NEW)

Database:  Examples seeded successfully (11 entries)
Build Status:  TypeScript compiles cleanly

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-06 22:32:29 +02:00
..