AI导哈

工作流自动化MCP服务器

一个模型上下文协议(MCP)服务器，使AI聊天机器人能够与n8n工作流自动化平台交互，提供工作流管理、编辑和执行功能。

  • by mbbill
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 mbbill/n8n-api-mcp

使用说明

n8n MCP服务器

模型上下文协议（MCP）服务器，使AI聊天机器人能够与n8n工作流自动化平台进行交互。

🎯 概述

此MCP服务器提供了通过自然语言命令管理、编辑和执行n8n工作流的全面工具。它可以与Claude Desktop和其他MCP兼容的AI工具集成，为您提供AI驱动的工作流管理功能。

✨ 特性

  • 🔄 工作流管理：列出、创建、更新和删除工作流
  • 🛠️ 工作流编辑：添加节点、修改配置和处理连接
  • ▶️ 执行管理：触发执行并监控结果
  • 🔐 凭据管理：管理API密钥和身份验证凭据
  • 📊 资源访问：通过MCP资源获取实时状态和数据
  • 🛡️ 安全：安全的API密钥身份验证和验证

🚀 可用的AI工具

工作流工具

  • list_workflows -列出带有筛选选项的工作流
  • get_workflow -获取详细的工作流信息
  • create_workflow -从自然语言描述创建工作流
  • update_workflow -更新工作流并添加新节点
  • delete_workflow -确认后删除工作流
  • activate_workflow / deactivate_workflow -控制工作流执行

执行工具

  • list_executions -列出执行情况并进行状态筛选
  • get_execution -获取详细的执行信息
  • get_workflow_executions -获取特定工作流的执行
  • get_execution_summary -获取执行统计数据
  • delete_execution -删除执行记录

凭证工具

  • list_credentials -列出配置的凭据
  • create_credential -创建新凭据
  • update_credential -更新现有凭据
  • delete_credential -删除凭据
  • get_credential_types -列出可用的凭据类型

🔧 设置

先决条件

  • Node.js 18+
  • 具有API访问权限的n8n实例
  • n8n API密钥

安装

  1. 克隆存储库

  2. 安装依赖项：

    npm install

  3. 创建一个 .env 模板中的文件：

    Copy-Item .env.example .env

  4. 编辑 .env 并设置您的n8n详细信息：

    N8N_API_URL=http://localhost:5678/api/v1
N8N_API_KEY=your_api_key_here

  5. 构建项目：

    npm run build

  6. 测试服务器：

    .\test-server.ps1

Claude桌面集成

将此配置添加到您的Claude Desktop配置文件中： (%APPDATA%\Claude\claude_desktop_config.json 在Windows上）

{
  "mcpServers": {
    "n8n": {
      "command": "node",
      "args": ["D:\\path\\to\\n8n-api-mcp\\dist\\index.js"],
      "env": {
        "N8N_API_URL": "http://localhost:5678/api/v1",
        "N8N_API_KEY": "your_api_key_here"
      }
    }
  }
}

更新配置后，重新启动Claude Desktop。

💬 使用示例

配置后，您可以在Claude Desktop中使用自然语言命令：

  • “列出我的n8n工作流”
  • “创建一个工作流，当我收到webhook时发送电子邮件”
  • “显示我的数据同步工作流的最近执行情况”
  • “将Slack通知添加到工作流ID abc123”
  • “配置了哪些凭据？”
  • “激活每日报告工作流”

🧪 发展

  • npm run dev -以监视模式启动开发服务器
  • npm run test -运行测试
  • npm run lint -Lint代码
  • npm run type-check -不发射的类型检查

📚 文档

  • docs/claude-desktop-setup.md -详细的设置说明
  • PROJECT-SUMMARY.md -完整的项目概述
  • test-server.ps1 -PowerShell安装验证脚本

🛠️ 构建于

  • TypeScript -类型安全开发
  • MCP-SDK -模型上下文协议实现
  • 阿西奥斯 -n8n API的HTTP客户端
  • 萨德 -运行时类型验证
  • 速度 -快速单元测试

📋 需求

  • Node.js 18+
  • 具有API访问权限的n8n实例
  • n8n API密钥（在n8n设置>API密钥中生成）

许可证

麻省理工学院

相关 MCP