n8n人工智能代理管理器
\[！重要\] 此存储库不再处于积极开发状态。 n8n实例管理工具已集成到更全面的 n8n mcp 该项目为n8n自动化提供了一个完整的AI代理解决方案。 请使用 n8n mcp 了解最新功能和更新。
 ](https://nodejs.org)   
模型上下文协议（MCP）服务器，使Claude Desktop和其他AI代理能够通过n8n API管理n8n工作流自动化实例。
🎯 项目概述
此MCP服务器为AI代理提供了以编程方式管理n8n工作流的工具。它实现了核心n8n API操作，并为API限制提供了智能解决方案。
✅ 什么在起作用
- 工作流管理：创建、读取、更新和删除工作流
- 执行监控：列出并查看执行详细信息，删除执行记录
- 网钩触发器：通过webhook端点执行工作流
- 健康监测：检查n8n实例连接和配置
🚧 当前限制
- 工作流激活：无法通过API激活/停用工作流（需要手动激活UI）
- 直接执行：不可用-必须使用webhook触发器
- 标签和凭证：只读字段，无法通过API设置
🚀 已实现的功能
- 工作流操作：n8n工作流的完整CRUD操作
- 执行管理：查看、列出和删除执行记录
- 基于Webhook的执行：通过webhook URL触发工作流
- 智能错误处理：自动删除只读字段，方法回退
- AI友好描述：通过示例和明确的限制来增强工具描述
- 基于光标的分页：高效处理大型结果集
- 健康监测：内置连接和配置检查
⚠️ API限制和解决方法
发现的局限性
- 工作流激活：The
active字段为只读-必须在UI中手动激活工作流 - 标签字段：创建和更新期间为只读
- PATCH方法：一些n8n实例不支持PATCH进行工作流更新
- 直接执行：必须使用webhook触发器（不直接执行API）
- 设置字段：必填但未记录-我们提供合理的默认值
未实现（API不可用）
- 用户管理：没有公共API终结点
- 凭据管理：API有限，架构未公开
- 停止执行：无法通过API停止运行执行
- 变量：仅通过源代码管理API提供
- 导入/导出：已计划但尚未实施
📦 可用的MCP工具
工作流管理
n8n_create_workflow-使用节点和连接创建新的工作流n8n_get_workflow-按ID检索工作流详细信息n8n_update_workflow-更新现有工作流（需要完整的节点列表）n8n_delete_workflow-永久删除工作流n8n_list_workflows-列出具有过滤和分页功能的工作流
执行管理
n8n_trigger_webhook_workflow-通过webhook URL触发工作流n8n_get_execution-获取详细的执行信息n8n_list_executions-列出执行情况并进行状态筛选n8n_delete_execution-删除执行记录
系统工具
n8n_health_check-检查API连接和配置
🛠️ 技术栈
- 运行时：Node.js 20+
- 语言：TypeScript 5.0
- MCP-SDK：@modelcontextprotocol/sdk v1.13.1
- HTTP客户端：带有重试逻辑的Axios
- 验证：Zod模式
- 日志记录：Winston（基于MCP模式的文件）
- 构建：带有ES模块的TypeScript
📋 先决条件
- Node.js 20或更高版本
- 已启用API访问的n8n实例
- n8n API密钥
- Claude Desktop（用于MCP集成）
🚀 快速开始
- 克隆存储库
git clone https://github.com/czlonkowski/n8n-manager-for-ai-agents
cd n8n-manager-for-ai-agents- 安装依赖项
npm install- 配置环境
cp .env.example .env
# Edit .env with your n8n instance details- 构建项目
npm run build- 配置Claude桌面
添加到您的Claude Desktop配置(~/Library/Application Support/Claude/claude_desktop_config.json 在 macOS 上：
{
"mcpServers": {
"n8n-manager": {
"command": "node",
"args": ["/absolute/path/to/n8n-manager-for-ai-agents/build/index.js"],
"env": {
"N8N_API_URL": "https://your-n8n-instance.com",
"N8N_API_KEY": "your-api-key",
"LOG_LEVEL": "info",
"NODE_ENV": "production",
"MCP_MODE": "stdio"
}
}
}
}- 重新启动克劳德桌面 并验证n8n管理器是否出现在MCP工具列表中
📁 日志文件
日志被写入 ~/.n8n-manager/logs/n8n-manager.log 以避免干扰MCP协议通信。
💡 使用示例
创建简单工作流
"Create a workflow named 'Test API' with a manual trigger"列出工作流
"Show me all active workflows"
"List workflows with tag 'production'"检查执行情况
"Show recent executions for workflow ID abc123"
"Get details of execution xyz789"Webhook 执行
"Trigger the webhook at https://n8n.example.com/webhook/abc-def-ghi"📖 文档
🧪 发展
# Run tests
npm test
# Run in development mode
npm run dev
# Type checking
npm run typecheck
# Linting
npm run lint
# Build for production
npm run build🤝 贡献
欢迎投稿！请随时提交拉取请求。对于重大更改，请先打开一个问题来讨论您想要更改的内容。
🔐 安全
- API密钥存储在环境变量中
- 未记录敏感数据
- 所有通信都使用HTTPS
- 实施速率限制和请求验证
📄 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
版权所有（c）2024 Romuald Czlonkowski@ aiadvisors.pl
🙏 致谢
📞 联系
罗穆阿尔德·楚隆科夫斯基\ aiadvisors.pl
______________________________________________________________________
*第一阶段完成：核心工作流程和执行管理工具功能齐全。看 CLAUDE.md 详细的使用指南和常见错误解决方案。*