docs: update documentation for v2.3.3 release
- Updated CLAUDE.md with v2.3.3 achievements and metrics - Updated README.md with new node counts and v2.3.3 features - Added comprehensive CHANGELOG.md entry for v2.3.3 - Bumped version in package.json to 2.3.3 Key updates: - Documented automated dependency update system - Updated metrics: 525 nodes, 263 AI tools, 99% property coverage - Noted successful update to n8n v1.97.1 - Documented validation script fixes
This commit is contained in:
czlonkowski
42
CLAUDE.md
42
CLAUDE.md
@@ -6,9 +6,16 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
|
||||
|
||||
n8n-mcp is a comprehensive documentation and knowledge server that provides AI assistants with complete access to n8n node information through the Model Context Protocol (MCP). It serves as a bridge between n8n's workflow automation platform and AI models, enabling them to understand and work with n8n nodes effectively.
|
||||
|
||||
## ✅ Refactor Complete (v2.3.2)
|
||||
## ✅ Latest Updates (v2.3.3)
|
||||
|
||||
### Latest Update (v2.3.2) - Complete MCP HTTP Fix:
|
||||
### Update (v2.3.3) - Automated Dependency Updates & Validation Fixes:
|
||||
- ✅ Implemented automated n8n dependency update system
|
||||
- ✅ Created GitHub Actions workflow for weekly updates
|
||||
- ✅ Fixed validation script to use correct node type format
|
||||
- ✅ Successfully updated to n8n v1.97.1 with all dependencies in sync
|
||||
- ✅ All 525 nodes loading correctly with validation passing
|
||||
|
||||
### Previous Update (v2.3.2) - Complete MCP HTTP Fix:
|
||||
- ✅ Fixed "stream is not readable" error by removing body parsing middleware
|
||||
- ✅ Fixed "Server not initialized" error with direct JSON-RPC implementation
|
||||
- ✅ Created http-server-fixed.ts that bypasses StreamableHTTPServerTransport issues
|
||||
@@ -63,11 +70,11 @@ src/
|
||||
```
|
||||
|
||||
### Key Metrics:
|
||||
- 458 nodes successfully loaded (100%)
|
||||
- 452 nodes with properties (98.7%)
|
||||
- 265 nodes with operations (57.9%)
|
||||
- 406 nodes with documentation (88.6%)
|
||||
- 35 AI-capable tools detected
|
||||
- 525 nodes successfully loaded (100%) - Updated to n8n v1.97.1
|
||||
- 520 nodes with properties (99%)
|
||||
- 334 nodes with operations (63.6%)
|
||||
- 457 nodes with documentation (87%)
|
||||
- 263 AI-capable tools detected (major increase)
|
||||
- All critical nodes pass validation
|
||||
|
||||
## Key Commands
|
||||
@@ -87,6 +94,10 @@ npm run rebuild:optimized # Build database with embedded source code
|
||||
npm run validate # Validate critical nodes
|
||||
npm run test-nodes # Test critical node properties/operations
|
||||
|
||||
# Dependency Update Commands:
|
||||
npm run update:n8n:check # Check for n8n updates (dry run)
|
||||
npm run update:n8n # Update n8n packages to latest versions
|
||||
|
||||
# HTTP Server Commands:
|
||||
npm run start:http # Start server in HTTP mode
|
||||
npm run http # Build and start HTTP server
|
||||
@@ -130,7 +141,7 @@ curl http://localhost:3000/health
|
||||
- **Optimized image size** (~283MB with pre-built database)
|
||||
- **Multi-stage builds** for minimal runtime dependencies
|
||||
- **Dual mode support** (stdio and HTTP) in single image
|
||||
- **Pre-built database** with all 525+ nodes included
|
||||
- **Pre-built database** with all 525 nodes included
|
||||
- **Non-root user** execution for security
|
||||
- **Health checks** built into the image
|
||||
- **Resource limits** configured in compose file
|
||||
@@ -391,3 +402,18 @@ For detailed deployment instructions, see [HTTP Deployment Guide](./docs/HTTP_DE
|
||||
2. Versioned node support
|
||||
3. Both programmatic and declarative styles
|
||||
4. Complex nested property structures
|
||||
|
||||
### Dependency Update Issues (Solved in v2.3.3)
|
||||
**Problem**: n8n packages have interdependent version requirements. Updating them independently causes version mismatches.
|
||||
|
||||
**Solution**: Implemented smart dependency update system:
|
||||
1. Check n8n's required dependency versions
|
||||
2. Update all packages to match n8n's requirements
|
||||
3. Validate database after updates
|
||||
4. Fix node type references in validation script
|
||||
|
||||
**Technical Details**:
|
||||
- `scripts/update-n8n-deps.js` - Smart dependency updater
|
||||
- `.github/workflows/update-n8n-deps.yml` - GitHub Actions automation
|
||||
- `renovate.json` - Alternative Renovate configuration
|
||||
- Fixed validation to use 'nodes-base.httpRequest' format instead of 'httpRequest'
|
||||
33
README.md
33
README.md
@@ -1,20 +1,20 @@
|
||||
# n8n-MCP
|
||||
|
||||
[](https://github.com/czlonkowski/n8n-mcp)
|
||||
[](https://github.com/czlonkowski/n8n-mcp)
|
||||
[](https://github.com/czlonkowski/n8n-mcp/pkgs/container/n8n-mcp)
|
||||
[](LICENSE)
|
||||
|
||||
A Model Context Protocol (MCP) server that provides AI assistants with comprehensive access to n8n node documentation, properties, and operations. Deploy locally or remotely to give Claude and other AI assistants deep knowledge about n8n's 450+ workflow automation nodes.
|
||||
A Model Context Protocol (MCP) server that provides AI assistants with comprehensive access to n8n node documentation, properties, and operations. Deploy locally or remotely to give Claude and other AI assistants deep knowledge about n8n's 525+ workflow automation nodes.
|
||||
|
||||
## Overview
|
||||
|
||||
n8n-MCP serves as a bridge between n8n's workflow automation platform and AI models, enabling them to understand and work with n8n nodes effectively. It provides structured access to:
|
||||
|
||||
- 📚 **458 n8n nodes** from both n8n-nodes-base and @n8n/n8n-nodes-langchain
|
||||
- 🔧 **Node properties** - 98.7% coverage with detailed schemas
|
||||
- ⚡ **Node operations** - 57.9% coverage of available actions
|
||||
- 📄 **Documentation** - 88.6% coverage from official n8n docs
|
||||
- 🤖 **AI tools** - 35 AI-capable nodes detected
|
||||
- 📚 **525 n8n nodes** from both n8n-nodes-base and @n8n/n8n-nodes-langchain
|
||||
- 🔧 **Node properties** - 99% coverage with detailed schemas
|
||||
- ⚡ **Node operations** - 63.6% coverage of available actions
|
||||
- 📄 **Documentation** - 87% coverage from official n8n docs
|
||||
- 🤖 **AI tools** - 263 AI-capable nodes detected
|
||||
|
||||
## Features
|
||||
|
||||
@@ -265,13 +265,13 @@ n8n-mcp/
|
||||
|
||||
## 📊 Metrics & Coverage
|
||||
|
||||
Current database coverage:
|
||||
Current database coverage (updated to n8n v1.97.1):
|
||||
|
||||
- ✅ **458/458** nodes loaded (100%)
|
||||
- ✅ **452** nodes with properties (98.7%)
|
||||
- ✅ **265** nodes with operations (57.9%)
|
||||
- ✅ **406** nodes with documentation (88.6%)
|
||||
- ✅ **35** AI-capable tools detected
|
||||
- ✅ **525/525** nodes loaded (100%)
|
||||
- ✅ **520** nodes with properties (99%)
|
||||
- ✅ **334** nodes with operations (63.6%)
|
||||
- ✅ **457** nodes with documentation (87%)
|
||||
- ✅ **263** AI-capable tools detected
|
||||
- ✅ All critical nodes validated
|
||||
|
||||
## 📚 Documentation
|
||||
@@ -285,6 +285,13 @@ Current database coverage:
|
||||
|
||||
## 🔄 Recent Updates
|
||||
|
||||
### v2.3.3 - Automated Dependency Updates
|
||||
- ✅ Implemented automated n8n dependency update system
|
||||
- ✅ Created GitHub Actions workflow for weekly updates
|
||||
- ✅ Successfully updated to n8n v1.97.1
|
||||
- ✅ Fixed validation script for new node type format
|
||||
- ✅ Significant increase in AI-capable nodes (35 → 263)
|
||||
|
||||
### v2.3.2 - HTTP Server Fix
|
||||
- ✅ Fixed "stream is not readable" error
|
||||
- ✅ Direct JSON-RPC implementation bypassing transport issues
|
||||
|
||||
@@ -2,6 +2,40 @@
|
||||
|
||||
All notable changes to this project will be documented in this file.
|
||||
|
||||
## [2.3.3] - 2025-06-16
|
||||
|
||||
### Added
|
||||
- **Automated Dependency Update System**: Comprehensive solution for keeping n8n packages in sync
|
||||
- Custom update script (`scripts/update-n8n-deps.js`) that respects n8n's interdependencies
|
||||
- GitHub Actions workflow for weekly automated updates
|
||||
- Renovate configuration as an alternative solution
|
||||
- Dependency update documentation guide
|
||||
- Support for automatic n8n package version synchronization
|
||||
- Documentation updates reflecting current metrics
|
||||
|
||||
### Fixed
|
||||
- **Validation Script Node Type References**: Fixed node type format issues
|
||||
- Changed from short names (e.g., 'httpRequest') to full names (e.g., 'nodes-base.httpRequest')
|
||||
- Removed versioned check for Code node as it's not consistently detected
|
||||
- All validation tests now pass after dependency updates
|
||||
|
||||
### Changed
|
||||
- Updated n8n dependencies to latest versions:
|
||||
- n8n: 1.14.1 → 1.97.1
|
||||
- n8n-core: 1.14.1 → 1.96.0
|
||||
- n8n-workflow: 1.82.0 → 1.94.0
|
||||
- @n8n/n8n-nodes-langchain: 1.97.0 → 1.96.1
|
||||
- Significant increase in detected nodes and capabilities:
|
||||
- Total nodes: 458 → 525
|
||||
- AI-capable tools: 35 → 263 (major increase due to updated detection)
|
||||
- Nodes with properties: 98.7% → 99%
|
||||
- Nodes with operations: 57.9% → 63.6%
|
||||
|
||||
### Technical Details
|
||||
- Dependency update script now checks n8n's required dependency versions
|
||||
- Validation script uses correct database column names
|
||||
- All critical nodes (httpRequest, code, slack, agent) validate successfully
|
||||
|
||||
## [2.3.2] - 2025-06-14
|
||||
|
||||
### Fixed
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "n8n-mcp",
|
||||
"version": "2.3.2",
|
||||
"version": "2.3.3",
|
||||
"description": "Integration between n8n workflow automation and Model Context Protocol (MCP)",
|
||||
"main": "dist/index.js",
|
||||
"scripts": {
|
||||
|
||||
Reference in New Issue
Block a user