Romuald Członkowski
ff69e4ccca
feat: Tool Consolidation - Reduce MCP Tools by 38% (v2.26.0) ( #439 )
...
* feat: Remove 9 low-value tools and consolidate n8n_health_check (v2.25.0)
Telemetry-driven tool cleanup to improve API clarity:
**Removed Tools (9):**
- list_nodes - Use search_nodes instead
- list_ai_tools - Use search_nodes with isAITool filter
- list_tasks - Low usage (0.02%)
- get_database_statistics - Use n8n_health_check
- list_templates - Use search_templates or get_templates_for_task
- get_node_as_tool_info - Documented in get_node
- validate_workflow_connections - Use validate_workflow
- validate_workflow_expressions - Use validate_workflow
- n8n_list_available_tools - Use n8n_health_check
- n8n_diagnostic - Merged into n8n_health_check
**Consolidated Tool:**
- n8n_health_check now supports mode='diagnostic' for detailed troubleshooting
**Tool Count:**
- Before: 38 tools
- After: 31 tools (18% reduction)
Concieved by Romuald Członkowski - www.aiadvisors.pl/en
🤖 Generated with [Claude Code](https://claude.ai/code )
Co-Authored-By: Claude <noreply@anthropic.com >
* fix: cleanup stale references and update tests after tool removal
- Remove handleListAvailableTools dead code from handlers-n8n-manager.ts
- Update error messages to reference n8n_health_check(mode="diagnostic") instead of n8n_diagnostic
- Update tool counts in diagnostic messages (14 doc tools, 31 total)
- Fix error-handling.test.ts to use valid tools (search_nodes, tools_documentation)
- Remove obsolete list-tools.test.ts integration tests
- Remove unused ListToolsResponse type from response-types.ts
- Update tools.ts QUICK REFERENCE to remove list_nodes references
- Update tools-documentation.ts to remove references to removed tools
- Update tool-docs files to remove stale relatedTools references
- Fix tools.test.ts to not test removed tools (list_nodes, list_ai_tools, etc.)
- Fix parameter-validation.test.ts to not test removed tools
- Update handlers-n8n-manager.test.ts error message expectations
All 399 MCP unit tests now pass.
Conceived by Romuald Członkowski - www.aiadvisors.pl/en
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com >
* fix: update integration tests to use valid tools after v2.25.0 removal
Replaced all references to removed tools in integration tests:
- list_nodes -> search_nodes
- get_database_statistics -> tools_documentation
- list_ai_tools -> search_nodes/tools_documentation
- list_tasks -> tools_documentation
- get_node_as_tool_info -> removed test section
Updated test files:
- tests/integration/mcp-protocol/basic-connection.test.ts
- tests/integration/mcp-protocol/performance.test.ts
- tests/integration/mcp-protocol/session-management.test.ts
- tests/integration/mcp-protocol/test-helpers.ts
- tests/integration/mcp-protocol/tool-invocation.test.ts
- tests/integration/telemetry/mcp-telemetry.test.ts
- tests/unit/mcp/disabled-tools.test.ts
- tests/unit/mcp/tools-documentation.test.ts
Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com >
* feat: Tool consolidation v2.26.0 - reduce tools by 38% (31 → 19)
Major consolidation of MCP tools using mode-based parameters for better
AI agent ergonomics:
Node Tools:
- get_node_documentation → get_node with mode='documentation'
- search_node_properties → get_node with mode='search_properties'
- get_property_dependencies → removed
Validation Tools:
- validate_node_operation + validate_node_minimal → validate_node with mode param
Template Tools:
- list_node_templates → search_templates with searchMode='nodes'
- search_templates_by_metadata → search_templates with searchMode='metadata'
- get_templates_for_task → search_templates with searchMode='task'
Workflow Getters:
- n8n_get_workflow_details/structure/minimal → n8n_get_workflow with mode param
Execution Tools:
- n8n_list/get/delete_execution → n8n_executions with action param
Test updates for all consolidated tools.
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com >
Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en
* docs: comprehensive README update for v2.26.0 tool consolidation
- Quick Start: Added hosted service (dashboard.n8n-mcp.com) as primary option
- Self-hosting: Renamed options to A (npx), B (Docker), C (Local), D (Railway)
- Removed: "Memory Leak Fix (v2.20.2)" section (outdated)
- Removed: "Known Issues" section (outdated container management)
- Claude Project Setup: Updated all tool references to v2.26.0 consolidated tools
- validate_node({mode: 'minimal'|'full'}) instead of separate tools
- search_templates({searchMode: ...}) unified template search
- get_node({mode: 'docs'|'search_properties'}) for documentation
- n8n_executions({action: ...}) unified execution management
- Available MCP Tools: Updated to show 19 consolidated tools (7 core + 12 mgmt)
- Recent Updates: Simplified to just link to CHANGELOG.md
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com >
Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en
* fix: update tool count from 31 to 19 in diagnostic message
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com >
* fix(tests): update tool count expectations for v2.26.0
Update handlers-n8n-manager.test.ts to expect new consolidated
tool counts (7/12/19) after v2.26.0 tool consolidation.
Conceived by Romuald Członkowski - www.aiadvisors.pl/en
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com >
---------
Co-authored-by: Claude <noreply@anthropic.com >
2025-11-25 18:39:00 +01:00
czlonkowski
4d3b8fbc91
fix: Remove outdated "Cannot activate" limitation from test expectations
...
After implementing workflow activation/deactivation operations, the
"Cannot activate" limitation no longer applies. Updated the test to
match the current API capabilities.
Related to #399
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com >
Conceived by Romuald Członkowski - www.aiadvisors.pl/en
2025-11-06 23:27:13 +01:00
czlonkowski
275e4f8cef
feat: add environment-aware debugging to diagnostic tools
...
Enhanced health check and diagnostic tools with environment-specific
troubleshooting guidance based on telemetry analysis of 632K events
from 5,308 users.
Key improvements:
- Environment-aware debugging suggestions for http/stdio modes
- Docker-specific troubleshooting when IS_DOCKER=true
- Cloud platform detection (Railway, Render, Fly, Heroku, AWS, K8s, GCP, Azure)
- Platform-specific configuration paths (macOS, Windows, Linux)
- MCP_MODE and platform tracking in telemetry events
- Comprehensive integration tests for environment detection
Addresses 59% session abandonment by providing actionable, context-specific
next steps based on user's deployment environment.
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com >
2025-10-10 12:34:20 +02:00
czlonkowski
c519cd5060
refactor: add TypeScript interfaces for test response types
...
Replace 'as any' type assertions with proper TypeScript interfaces for improved type safety in Phase 8 integration tests.
Changes:
- Created response-types.ts with comprehensive interfaces for all response types
- Updated health-check.test.ts to use HealthCheckResponse interface
- Updated list-tools.test.ts to use ListToolsResponse interface
- Updated diagnostic.test.ts to use DiagnosticResponse interface
- Added null-safety checks for optional fields (data.debug)
- Used non-null assertions (!) for values verified with expect().toBeDefined()
- Removed unnecessary 'as any' casts throughout test files
Benefits:
- Better type safety and IDE autocomplete
- Catches potential type mismatches at compile time
- More maintainable and self-documenting code
- Consistent with code review recommendation
All 19 tests still passing with full type safety.
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com >
2025-10-05 10:45:30 +02:00
czlonkowski
69f3a31d41
feat: implement Phase 8 integration tests for system tools
...
Implement comprehensive integration tests for 3 system tool handlers:
- handleHealthCheck (3 tests): API connectivity, version checking, feature availability
- handleListAvailableTools (7 tests): Tool discovery by category, configuration status, API limitations
- handleDiagnostic (9 tests): Environment checks, API status, tools availability, verbose mode
All 19 tests passing against real n8n instance.
Coverage:
- Health check: API availability verification, version information, feature discovery
- Tool listing: All categories (Workflow Management, Execution Management, System), configuration details
- Diagnostics: Environment variables, API connectivity, tool availability, troubleshooting steps, verbose debug mode
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com >
2025-10-05 10:25:41 +02:00
