AI导哈

N8N工作流AI助手

一个基于Claude和模型上下文协议(MCP)的AI助手，提供N8N工作流分析、检查、自然语言查询和技术支持功能。

  • by MohammedRayid
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 MohammedRayid/n8n-copilot

使用说明

N8N MCP副驾驶

使用Claude和模型上下文协议（MCP）的N8N工作流的AI辅助副驾驶，具有AI辅助分析、工作流列表、工作流检查、自然语言查询和技术支持等功能。

概述

该项目将Claude AI集成为N8N自动化工作流程的智能副驾驶。使用模型上下文协议，它提供：

  • 工作流列表：使用元数据浏览所有N8N工作流
  • 工作流程分析：获取工作流结构、节点和连接的详细说明
  • 工作流检查：检查完整的工作流配置和逻辑流
  • 人工智能辅助：通过智能见解自然地谈论N8N自动化
  • 代码分析：帮助理解和改进N8N工作流设计

特性

✅ 目前正在工作

  • 使用N8N API密钥进行身份验证
  • 检索所有工作流信息
  • 工作流结构和流程分析
  • 与Claude集成，实现智能工作流理解

🚧 未来的增强功能

  • 工作流创建和修改功能（计划中）
  • 高级错误处理和API管理
  • 用于N8N附加功能的可扩展MCP框架

需求

  • N8N实例（本地主机：5678或托管）
  • 具有工作流访问功能的N8N API密钥
  • 带Cline扩展的VSCode
  • 克劳德访问

设置

  1. 构建MCP服务器：

    cd MCP/n8n-copilot
npm install
npm run build

  2. 配置MCP设置：

    • 更新 cline_mcp_settings.json 使用API密钥
    • 重新启动VSCode

  3. 开始使用：

    • 与Claude/Cline讨论N8N工作流程
    • 示例：“分析我的工作流”或“列出所有工作流”

文件结构

n8nCopilot/
├── MCP/
│   └── n8n-copilot/          # MCP server for N8N
│       ├── src/n8n-copilot/index.ts  # Main MCP implementation
│       ├── package.json      # Dependencies
│       ├── tsconfig.json     # TypeScript config
│       └── build/            # Compiled tools
├── README.md                 # This file
└── BEGINNER_GUIDE.md         # Step-by-step explanation

技术架构

  • MCP框架：使用模型上下文协议进行AI扩展
  • TypeScript：强有力的执行
  • REST API：与N8N的v1 API直接集成
  • 认证：安全的API密钥处理

用法示例

"Show me all my N8N workflows"
"Get details of workflow PVaQcqc5nm7qhvPT"
"Analyze how the JoblyFit workflow works"
"What does this workflow do?"

项目状态

  • ✅ 核心MCP集成工作
  • ✅ 读取操作（列表、获取、分析）功能齐全
  • � 写入操作（创建、更新、删除）尚未实现

贡献

MCP框架为在AI辅助下扩展N8N自动化功能提供了坚实的基础。

相关 MCP