remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Integrations
Provides tools for programmatic creation and management of n8n workflows, allowing for listing, creating, updating, deleting, activating and deactivating workflows, as well as managing workflow executions.
Utilizes Zod for comprehensive schema validation of both input and output data in workflow management operations.
mcp-n8n-builder
一个模型上下文协议 (MCP) 服务器，用于以编程方式创建和管理 n8n 工作流。该服务器提供与 n8n REST API 交互的工具和资源，使 AI 助手无需用户直接干预即可构建、修改和管理工作流。
特征
- 🔄工作流管理：创建、读取、更新、删除、激活和停用工作流
- 📊执行管理：列出并检索工作流执行详细信息
- ✅模式验证：使用 Zod 对输入和输出数据进行全面验证
- 🔍节点验证：在创建工作流之前根据 n8n 的可用节点验证节点类型，以防止出现错误
- 🤔智能建议：当检测到无效节点时，提供类似节点类型的建议
- 🛠️错误处理：用于故障排除的详细错误消息
- 📝文档：所有工具和资源的详尽文档
- 🔍搜索和过滤：按名称、标签或活动状态过滤工作流程
配置
此服务器需要通过您的 MCP 客户端进行配置。以下是不同环境的示例：
克莱恩配置
将其添加到您的 Cline MCP 设置中：
带有 WSL 配置的 Claude 桌面
对于 WSL 环境，将其添加到您的 Claude Desktop 配置中：
环境变量
可以使用环境变量来配置服务器：
| 多变的 | 描述 | 默认 |
|---|---|---|
N8N_HOST | n8n API 的 URL | http://localhost:5678/api/v1 |
N8N_API_KEY | n8n 身份验证的 API 密钥 | "" |
SERVER_NAME | MCP 服务器的名称 | "n8n-workflow-builder" |
SERVER_VERSION | MCP 服务器版本 | 软件包版本 |
LOG_LEVEL | 日志级别 | "info" |
CACHE_ENABLED | 启用缓存 | false |
CACHE_TTL | 缓存 TTL（以秒为单位） | 300 |
OUTPUT_VERBOSITY | 输出详细程度（ concise或full ） | "concise" |
MCP 工具
节点管理
list_available_nodes：列出 n8n 实例中所有可用的节点。重要提示：在创建或更新工作流之前使用此工具，以确保仅使用有效的节点类型。这有助于防止因使用当前 n8n 实例中不存在的节点类型而导致的错误。
工作流管理
list_workflows：列出 n8n 的所有工作流及其基本信息，包括 ID、名称、状态、创建日期和标签。结果可以按活动状态、标签或名称进行筛选。create_workflow：在 n8n 中创建一个包含指定节点和连接的新工作流。返回已创建的工作流及其指定的 ID。验证所有节点类型是否存在于 n8n 实例中。get_workflow：通过 ID 检索特定工作流的完整详细信息，包括所有节点、连接、设置和元数据。update_workflow：使用新配置更新现有工作流。必须提供完整的工作流结构，而不仅仅是更改的部分。验证 n8n 实例中是否存在所有节点类型。delete_workflow：根据 ID 永久删除工作流。此操作不可撤消。activate_workflow：通过 ID 激活工作流，使其能够根据触发器自动运行。deactivate_workflow：通过 ID 停用工作流，防止其自动运行。
执行管理
list_executions：列出工作流执行历史记录，其中包含成功/失败状态、持续时间和时间戳的详细信息。结果可以按工作流 ID、状态进行筛选，并限制为特定数量。get_execution：检索有关特定工作流执行的详细信息，包括执行时间、状态以及可选的每个步骤处理的完整数据。
MCP 资源
n8n://workflows：n8n 中所有工作流程的列表n8n://workflows/{id}：特定 n8n 工作流的详细信息n8n://executions/{id}：特定 n8n 工作流执行的详细信息
发展
设置
- 克隆存储库
- 安装依赖项：
- 构建项目：
- 以开发模式运行：
出版
该项目使用变更集进行版本管理。要发布：
- 创建变更集：
- 对包进行版本控制：
- 发布到 npm：
贡献
欢迎贡献代码！欢迎提交 Pull 请求。
执照
MIT 许可证 - 有关详细信息，请参阅LICENSE文件。
致谢
You must be authenticated.
Tools
🪄 MCP 服务器，用于以编程方式创建和管理 n8n 工作流。通过一套全面的工具和资源与 n8n 的 REST API 进行交互，AI 助手无需用户直接干预即可构建、修改和管理工作流。