AI导哈

AI代理n8n管理器

一个MCP服务器，使Claude Desktop和其他AI代理能够通过n8n API管理n8n工作流自动化实例。

  • by czlonkowski
  • TypeScript
  • 本地部署
  • 62 星标
  • 更新于
在 GitHub 查看 czlonkowski/n8n-manager-for-ai-agents

使用说明

n8n人工智能代理管理器

[！重要] 此存储库不再处于积极开发状态。 n8n实例管理工具已集成到更全面的 n8n mcp 该项目为n8n自动化提供了一个完整的AI代理解决方案。

请使用 n8n mcp 了解最新功能和更新。

模型上下文协议（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集成）

🚀 快速开始

  1. 克隆存储库

    git clone https://github.com/czlonkowski/n8n-manager-for-ai-agents
cd n8n-manager-for-ai-agents

  2. 安装依赖项

    npm install

  3. 配置环境

    cp .env.example .env
# Edit .env with your n8n instance details

  4. 构建项目

    npm run build

  5. 配置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"
      }
    }
  }
}

  6. 重新启动克劳德桌面 并验证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 详细的使用指南和常见错误解决方案。

相关 MCP