czlonkowski / n8n-mcp

n8n-MCP is a Model Context Protocol (MCP) server that provides AI assistants with comprehensive access to n8n node documentation, properties, and operations. Deploy in minutes to give Claude and other AI assistants deep knowledge about n8n’s 1,650 workflow automation nodes (820 core + 830 community). n8n-MCP 是一个模型上下文协议 (MCP) 服务器，为 AI 助手提供对 n8n 节点文档、属性和操作的全面访问权限。只需几分钟即可部署，让 Claude 和其他 AI 助手深入了解 n8n 的 1,650 个工作流自动化节点（820 个核心节点 + 830 个社区节点）。

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: n8n-MCP 充当了 n8n 工作流自动化平台与 AI 模型之间的桥梁，使它们能够有效地理解并使用 n8n 节点。它提供了以下内容的结构化访问：

• 1,650 n8n nodes - 820 core nodes + 830 community nodes (741 verified)
• 1,650 个 n8n 节点 - 820 个核心节点 + 830 个社区节点（741 个已验证）
• Node properties - 99% coverage with detailed schemas
• 节点属性 - 99% 的覆盖率，包含详细的架构信息
• Node operations - 63.6% coverage of available actions
• 节点操作 - 63.6% 的可用操作覆盖率
• Documentation - 87% coverage from official n8n docs (including AI nodes)
• 文档 - 87% 的官方 n8n 文档覆盖率（包括 AI 节点）
• AI tools - 265 AI-capable tool variants detected with full documentation
• AI 工具 - 检测到 265 种具备 AI 能力的工具变体，并附带完整文档
• Real-world examples - 156 ranked configurations extracted from popular templates
• 实际案例 - 从热门模板中提取的 156 个排名配置
• Template library - 2,352 workflow templates with 99.96% AI metadata coverage
• 模板库 - 2,352 个工作流模板，AI 元数据覆盖率达 99.96%
• Community nodes - Search verified community integrations with source filter
• 社区节点 - 通过来源筛选搜索已验证的社区集成

Support This Project

支持本项目

n8n-mcp started as a personal tool but now helps tens of thousands of developers automate their workflows efficiently. Maintaining and developing this project competes with my paid work. Your sponsorship helps me dedicate focused time to new features, respond quickly to issues, keep documentation up-to-date, and ensure compatibility with latest n8n releases. Become a sponsor. n8n-mcp 最初是一个个人工具，但现在已帮助数以万计的开发者高效地自动化其工作流。维护和开发该项目占用了我的工作时间。您的赞助将帮助我投入更多精力开发新功能、快速响应问题、保持文档更新，并确保与最新的 n8n 版本兼容。成为赞助者。

Important Safety Warning

重要安全警告

NEVER edit your production workflows directly with AI! Always: Make a copy of your workflow before using AI tools, test in development environment first, export backups of important workflows, and validate changes before deploying to production. AI results can be unpredictable. Protect your work! 切勿直接使用 AI 编辑生产环境的工作流！请务必：在使用 AI 工具前备份工作流，先在开发环境中进行测试，导出重要工作流的备份，并在部署到生产环境前验证更改。AI 的结果可能具有不可预测性。保护好您的工作！

Quick Start

快速开始

The fastest way to try n8n-MCP - no installation, no configuration: dashboard.n8n-mcp.com 尝试 n8n-MCP 最快的方法——无需安装，无需配置：dashboard.n8n-mcp.com

• Free tier: 100 tool calls/day
• 免费层级：每天 100 次工具调用
• Instant access: Start building workflows immediately
• 即时访问：立即开始构建工作流
• Always up-to-date: Latest n8n nodes and templates
• 始终保持最新：最新的 n8n 节点和模板
• No infrastructure: We handle everything
• 无需基础设施：我们处理一切
• Just sign up, get your API key, and connect your MCP client.
• 只需注册，获取您的 API 密钥，并连接您的 MCP 客户端。

Want to self-host? See the Self-Hosting Guide for npx, Docker, Railway, and local installation options. 想要自托管？请参阅自托管指南，了解 npx、Docker、Railway 和本地安装选项。

n8n Integration

n8n 集成

Want to use n8n-MCP with your n8n instance? Check out our comprehensive n8n Deployment Guide for: 想要在您的 n8n 实例中使用 n8n-MCP？请查看我们全面的n8n 部署指南，了解：

• Local testing with the MCP Client Tool node
• 使用 MCP 客户端工具节点进行本地测试
• Production deployment with Docker Compose
• 使用 Docker Compose 进行生产环境部署
• Cloud deployment on Hetzner, AWS, and other providers
• 在 Hetzner、AWS 和其他云服务商上的部署
• Troubleshooting and security best practices
• 故障排除和安全最佳实践

Connect your IDE

连接您的 IDE

n8n-MCP works with multiple AI-powered IDEs and tools: n8n-MCP 可与多种 AI 驱动的 IDE 和工具配合使用：

• Claude Code - Quick setup for Claude Code CLI
• Claude Code - Claude Code CLI 的快速设置
• Visual Studio Code - VS Code with GitHub Copilot integration
• Visual Studio Code - 集成 GitHub Copilot 的 VS Code
• Cursor - Step-by-step Cursor IDE setup
• Cursor - Cursor IDE 分步设置
• Windsurf - Windsurf integration with project rules
• Windsurf - 带有项目规则的 Windsurf 集成
• Codex - Codex integration guide
• Codex - Codex 集成指南
• Antigravity - Antigravity integration guide
• Antigravity - Antigravity 集成指南

Add Claude Skills (Optional)

添加 Claude 技能（可选）

Supercharge your n8n workflow building with specialized skills that teach AI how to build production-ready workflows! Learn more: n8n-skills repository. 通过专门的技能增强您的 n8n 工作流构建能力，教导 AI 如何构建生产就绪的工作流！了解更多：n8n-skills 仓库。

Claude Project Setup

Claude 项目设置

For the best results when using n8n-MCP with Claude Projects, use these enhanced system instructions: 为了在使用 Claude Projects 时获得最佳效果，请使用以下增强的系统指令：

You are an expert in n8n automation software using n8n-MCP tools. Your role is to design, build, and validate n8n workflows with maximum accuracy and efficiency. 您是一位使用 n8n-MCP 工具的 n8n 自动化软件专家。您的职责是以最高的准确性和效率设计、构建和验证 n8n 工作流。

Core Principles

核心原则

1. Silent Execution: CRITICAL: Execute tools without commentary. Only respond AFTER all tools complete. 静默执行：关键：执行工具时不要添加评论。仅在所有工具执行完毕后进行回复。
2. Parallel Execution: When operations are independent, execute them in parallel for maximum performance. 并行执行：当操作相互独立时，并行执行以获得最佳性能。
3. Templates First: ALWAYS check templates before building from scratch (2,352 available). 模板优先：在从零开始构建之前，务必先检查模板（现有 2,352 个）。
4. Multi-Level Validation: Use validate_node(mode='minimal') → validate_node(mode='full') → validate_workflow pattern. 多级验证：使用 validate_node(mode='minimal') → validate_node(mode='full') → validate_workflow 模式。
5. Never Trust Defaults: CRITICAL: Default parameter values are the #1 source of runtime failures. ALWAYS explicitly configure ALL parameters that control node behavior. 切勿信任默认值：关键：默认参数值是运行时故障的首要原因。务必显式配置所有控制节点行为的参数。