AI导哈

工作流管理服务器

一个用于与n8n工作流自动化平台交互的MCP服务器，提供工作流管理、执行监控和实例信息查询功能。

  • by allanbchancery
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 allanbchancery/n8n-mcp-server

使用说明

n8n MCP服务器

一个模型上下文协议（MCP）服务器，提供与n8n工作流自动化平台交互的工具。此服务器使您能够通过MCP兼容客户端管理工作流、执行和监视n8n实例。

特性

工作流管理

  • list_workflows -获取所有工作流及其状态和元数据
  • get_workflow -检索特定工作流的详细信息
  • activate_workflow -激活工作流以开始自动执行
  • deactivate_workflow -停用工作流以停止自动执行
  • execute_workflow -手动触发工作流执行

执行监控

  • list_executions -使用可选筛选获取最近的工作流执行情况
  • get_execution -获取特定执行的详细信息
  • stop_execution -停止当前正在运行的执行

实例信息

  • get_instance_info -获取n8n实例信息和运行状况

安装

  1. 克隆此存储库：
git clone <repository-url>
cd n8n-thg-server
  1. 安装依赖项：
npm install
  1. 构建项目：
npm run build

配置

环境变量

创建一个 .env 文件或设置以下环境变量：

N8N_API_KEY=your_n8n_api_key_here
N8N_BASE_URL=https://your-n8n-instance.com

获取n8n API密钥

  1. 登录您的n8n实例
  2. 转到“设置”→ API密钥
  3. 创建新的API密钥
  4. 复制生成的密钥

MCP服务器设置

将服务器添加到MCP客户端配置中：

对于Cline（VSCode扩展）

添加到MCP设置文件(cline_mcp_settings.json):

{
  "mcpServers": {
    "n8n-thg-server": {
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/n8n-thg-server/build/index.js"],
      "env": {
        "N8N_API_KEY": "your_api_key_here",
        "N8N_BASE_URL": "https://your-n8n-instance.com"
      },
      "autoApprove": []
    }
  }
}

适用于克劳德桌面

添加到您的Claude Desktop配置(claude_desktop_config.json):

{
  "mcpServers": {
    "n8n-thg-server": {
      "command": "node",
      "args": ["/path/to/n8n-thg-server/build/index.js"],
      "env": {
        "N8N_API_KEY": "your_api_key_here",
        "N8N_BASE_URL": "https://your-n8n-instance.com"
      }
    }
  }
}

使用示例

配置MCP服务器后，您可以通过MCP客户端使用它：

  • “显示我的所有n8n工作流”
  • “列出最近执行的工作流”
  • “执行ID为123的工作流”
  • “获取执行的详细信息456”
  • “激活工作流789”
  • “让我看看今天失败的处决”

发展

项目结构

n8n-thg-server/
├── src/
│   └── index.ts          # Main server implementation
├── build/                # Compiled JavaScript (generated)
├── package.json          # Project configuration
├── tsconfig.json         # TypeScript configuration
└── README.md            # This file

脚本

  • npm run build -将TypeScript编译为JavaScript
  • npm run dev -开发观看模式
  • npm start -运行已编译的服务器

建筑

npm run build

这将TypeScript源代码编译为JavaScript build/ 目录。

身份验证说明

Cloudflare访问保护实例

如果您的n8n实例受Cloudflare Access保护（在企业设置中很常见），您可能需要额外的配置：

  1. 确保您的API密钥具有适当的权限
  2. 配置服务帐户身份验证（如果可用）
  3. 请与系统管理员联系以获取API访问配置

该服务器包括用于企业环境中常用的自签名证书的SSL证书处理。

故障排除

常见问题

  1. 连接错误：验证您的 N8N_BASE_URL 和 N8N_API_KEY
  2. SSL证书问题：服务器自动处理自签名证书
  3. 身份验证错误：检查您的n8n实例是否需要额外的身份验证步骤

调试模式

设置详细日志记录的环境变量：

DEBUG=true node build/index.js

贡献

  1. 分叉存储库
  2. 创建要素分支
  3. 进行更改
  4. 如果适用，添加测试
  5. 提交拉取请求

许可证

MIT许可证-有关详细信息，请参阅许可证文件

支持

对于问题和疑问：

  • 检查上面的故障排除部分
  • 审查n8n API文档
  • 在此存储库中打开问题

相关 MCP