docs: update README and documentation to match current state (v2.5.1)
- Update n8n version from v1.97.1 to v1.99.1 in README - Fix 7 broken documentation links to point to existing files - Standardize Docker image size to ~280MB across all docs (was inconsistent: 150MB/200MB/283MB) - Add missing npm scripts for test commands (test:essentials, test:enhanced-validation, etc.) - Update CHANGELOG.md with missing versions 2.4.0 through 2.5.1 - Update README_CLAUDE_SETUP.md to list all 21+ MCP tools (was only showing 6) - Document 5 additional npm scripts in CLAUDE.md - Update AI-capable nodes count to 263 (was 35 in old docs) All documentation now accurately reflects the current codebase state. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
# Claude Desktop Configuration for n8n-MCP
|
||||
|
||||
This guide helps you connect n8n-MCP to Claude Desktop, giving Claude comprehensive knowledge about n8n's 525+ workflow automation nodes.
|
||||
This guide helps you connect n8n-MCP to Claude Desktop, giving Claude comprehensive knowledge about n8n's 525 workflow automation nodes, including 263 AI-capable tools.
|
||||
|
||||
## 🎯 Prerequisites
|
||||
|
||||
@@ -50,14 +50,13 @@ No installation needed - runs directly from Docker:
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"n8n-docker": {
|
||||
"n8n-mcp": {
|
||||
"command": "docker",
|
||||
"args": [
|
||||
"run", "--rm", "-i",
|
||||
"run", "-i", "--rm",
|
||||
"-e", "MCP_MODE=stdio",
|
||||
"-e", "LOG_LEVEL=error",
|
||||
"-e", "DISABLE_CONSOLE_OUTPUT=true",
|
||||
"-v", "n8n-mcp-data:/app/data",
|
||||
"ghcr.io/czlonkowski/n8n-mcp:latest"
|
||||
]
|
||||
}
|
||||
@@ -113,23 +112,47 @@ After restarting Claude Desktop:
|
||||
2. Try asking Claude: "What n8n nodes are available for working with Slack?"
|
||||
3. Or use a tool directly: "Use the list_nodes tool to show me trigger nodes"
|
||||
|
||||
## 🔧 Available Tools
|
||||
## 🔧 Available Tools (v2.5.1)
|
||||
|
||||
Once connected, you can ask Claude to:
|
||||
### Essential Tool - Start Here!
|
||||
- **`start_here_workflow_guide`** - Essential guide and best practices (ALWAYS use this first!)
|
||||
|
||||
- **List nodes**: "Show me all n8n nodes for working with databases"
|
||||
- **Get node details**: "How do I use the HTTP Request node?"
|
||||
- **Search documentation**: "Find n8n nodes that support OAuth"
|
||||
- **Find AI tools**: "What AI-capable nodes are available?"
|
||||
- **View statistics**: "Show me n8n-MCP database statistics"
|
||||
### Core Tools
|
||||
- **`list_nodes`** - List all n8n nodes with filtering options
|
||||
- **`get_node_info`** - Get comprehensive information (now includes aiToolCapabilities)
|
||||
- **`get_node_essentials`** - Get only 10-20 essential properties (95% smaller!)
|
||||
- **`search_nodes`** - Full-text search across all node documentation
|
||||
- **`search_node_properties`** - Find specific properties within nodes
|
||||
- **`get_node_documentation`** - Get parsed documentation from n8n-docs
|
||||
- **`get_database_statistics`** - View database metrics and coverage
|
||||
|
||||
Claude will automatically use the appropriate tools:
|
||||
- `list_nodes` - Filter and list nodes
|
||||
- `get_node_info` - Get detailed node information
|
||||
- `search_nodes` - Full-text search
|
||||
- `list_ai_tools` - Find AI-capable nodes
|
||||
- `get_node_documentation` - Get official docs
|
||||
- `get_database_statistics` - View coverage metrics
|
||||
### AI Tools (Enhanced in v2.5.1)
|
||||
- **`list_ai_tools`** - List AI-capable nodes (ANY node can be used as AI tool!)
|
||||
- **`get_node_as_tool_info`** - Get guidance on using any node as an AI tool
|
||||
|
||||
### Task & Template Tools
|
||||
- **`get_node_for_task`** - Pre-configured node settings for common tasks
|
||||
- **`list_tasks`** - Discover available task templates
|
||||
- **`list_node_templates`** - Find workflow templates using specific nodes
|
||||
- **`get_template`** - Get complete workflow JSON for import
|
||||
- **`search_templates`** - Search templates by keywords
|
||||
- **`get_templates_for_task`** - Get curated templates for common tasks
|
||||
|
||||
### Validation Tools (Professional Grade)
|
||||
- **`validate_node_operation`** - Smart validation with operation awareness
|
||||
- **`validate_node_minimal`** - Quick validation for just required fields
|
||||
- **`validate_workflow`** - Complete workflow validation (validates AI tool connections)
|
||||
- **`validate_workflow_connections`** - Check workflow structure
|
||||
- **`validate_workflow_expressions`** - Validate n8n expressions including $fromAI()
|
||||
- **`get_property_dependencies`** - Analyze property visibility conditions
|
||||
|
||||
### Example Questions to Ask Claude:
|
||||
- "Show me all n8n nodes for working with databases"
|
||||
- "How do I use the HTTP Request node?"
|
||||
- "Get the essentials for Slack node" (uses get_node_essentials)
|
||||
- "How can I use Google Sheets as an AI tool?"
|
||||
- "Validate my workflow before deployment"
|
||||
- "Find templates for webhook automation"
|
||||
|
||||
## 🔍 Troubleshooting
|
||||
|
||||
|
||||
Reference in New Issue
Block a user