N8n Workflow Downloader MCP

n8n工作流下载器MCP服务器

](https://badge.fury.io/js/n8n-workflow-downloader-mcp)

MCP（模型上下文协议）服务器，使AI代理能够从URL下载n8n工作流。

特性

• 从以下URL下载n8n工作流 https://n8n.io/workflows/3442
• 返回完整的工作流JSON结构
• 包括元数据（工作流ID、名称、URL）
• 优雅地处理错误

安装

作为一个全球性的npm包

npm install -g n8n-workflow-downloader-mcp

为了发展

git clone https://github.com/andrewlwn77/n8n-workflow-downloader-mcp.git
cd n8n-workflow-downloader-mcp
npm install
npm run build

用法

使用Claude Desktop或其他MCP客户端

添加到MCP配置中：

使用npx（推荐）：

{
  "mcpServers": {
    "n8n-workflow-downloader": {
      "command": "npx",
      "args": ["n8n-workflow-downloader-mcp"],
      "transport": {
        "type": "stdio"
      },
      "env": {
        "PUPPETEER_EXECUTABLE_PATH": "/opt/google/chrome/google-chrome"
      }
    }
  }
}

如果通过npm全局安装：

{
  "mcpServers": {
    "n8n-workflow-downloader": {
      "command": "n8n-workflow-downloader",
      "transport": {
        "type": "stdio"
      },
      "env": {
        "PUPPETEER_EXECUTABLE_PATH": "/opt/google/chrome/google-chrome"
      }
    }
  }
}

如果本地安装或从源安装：

{
  "mcpServers": {
    "n8n-workflow-downloader": {
      "command": "node",
      "args": ["./path/to/build/index.js"],
      "transport": {
        "type": "stdio"
      },
      "env": {
        "PUPPETEER_EXECUTABLE_PATH": "/opt/google/chrome/google-chrome"
      }
    }
  }
}

环境变量

• PUPPETEER_EXECUTABLE_PATH （可选）：Chrome/Chromium可执行文件的路径

- 如果没有设置，Puppeteer将使用其捆绑的Chromium - 适用于在非标准位置安装Chrome的系统 - 例子： /opt/google/chrome/google-chrome, /usr/bin/chromium-browser

可用工具

download_n8n_workflow

从给定的URL下载n8n工作流。

输入：

• url （string，必填）：n8n工作流URL（例如。，https://n8n.io/workflows/3442)

输出：

• workflow：完整的n8n工作流JSON对象
• metadata：对象包含：

- id：工作流ID - name：工作流名称 - url：原始URL

Claude中的示例用法：

Please download the n8n workflow from https://n8n.io/workflows/3442

发展

# Install dependencies
npm install

# Build TypeScript
npm run build

# Watch mode for development
npm run dev

# Run tests
npm test

# Run specific test suites
npm run test:unit        # Unit tests only
npm run test:integration # Integration tests only

# Run tests in watch mode
npm run test:watch

# Generate test coverage report
npm run test:coverage

# Test the server manually (for debugging/development)
node test-server.js

测试

该项目包括全面的测试覆盖范围：

• 单元测试 (tests/unit/)：单独测试单个模块

- 下载器模块验证和错误处理 - URL解析和验证 - 模拟木偶师互动

• 集成测试 (tests/integration/)：测试完整的MCP服务器

- 服务器初始化 - 工具列表和发现 - 端到端工作流下载模拟 - 错误处理和验证

跑 npm test 执行所有测试，或使用上面列出的特定测试命令。

手动测试

这 test-server.js 脚本提供了一种手动测试MCP服务器的快速方法：

• 初始化服务器
• 列出可用工具
• 演示工具调用
• 显示实时服务器输出

这对于调试和开发很有用，可以补充自动化测试套件。

技术细节

• 使用Puppeteer自动化工作流下载过程
• 拦截剪贴板操作以捕获工作流JSON
• 使用TypeScript和官方MCP SDK构建
• 实现本地通信的stdio传输
• 支持通过以下方式自定义Chrome/Chromium可执行路径 PUPPETEER_EXECUTABLE_PATH

需求

• Node.js 16+
• 铬/铬（用于Puppeter）