n8n MCP Server
2025.03.10
7
TypeScript工作流管理自动化工具开发效率
n8n MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，旨在通过 Smithery Model Context Protocol 实现 LLMs 和 AI 代理对 n8n 工作流的无缝管理。该服务提供了工作流列表查看、详情获取、执行、监控以及参数传递等功能，适用于需要自动化工作流管理的场景。
View on GitHub
Overview
基本能力
产品定位
n8n MCP Server 是一个中间件服务，旨在通过 MCP 协议为 LLMs 和 AI 代理提供对 n8n 工作流的管理能力。
核心功能
- 列出 n8n 实例中的可用工作流
- 查看工作流详情
- 执行工作流
- 监控工作流执行状态
- 向工作流传递参数
- 提供 MCP 兼容接口供 AI 代理使用
适用场景
- 在 AI 代理中集成 n8n 工作流管理
- 自动化工作流执行和监控
- 开发需要与 n8n 交互的 AI 应用
工具列表
- n8n_list_workflows: 列出 n8n 实例中的所有工作流
- n8n_get_workflow: 获取特定工作流的详细信息
- n8n_execute_workflow: 执行一个 n8n 工作流
- n8n_get_executions: 获取工作流的执行历史
- n8n_activate_workflow: 激活一个工作流
- n8n_deactivate_workflow: 停用一个工作流
常见问题解答
- 连接拒绝错误: 确保 n8n 实例正在运行且可通过 N8N_BASE_URL 访问
- API 密钥问题: 验证 n8n API 密钥是否正确并具有适当权限
- Docker 问题: 在尝试构建或运行 Docker 镜像前确保 Docker 正在运行
使用教程
使用依赖
- Node.js (v14+)
- 具有 API 访问权限的 n8n 实例
- 支持 Model Context Protocol 的 LLM 或 AI 代理
安装教程
-
安装包
bash npm install @dopehunter/n8n-mcp-server -
创建 .env 文件
bash cp .env.example .env -
配置 n8n 连接 编辑
.env文件并设置: N8N_BASE_URL: 你的 n8n 实例 URL (例如http://localhost:5678/api)-
N8N_API_KEY: 你的 n8n API 密钥 (在 n8n 设置中生成) -
启动服务器
bash npm start
调试方式
测试服务器是否正常运行:
curl -X POST http://localhost:3000/mcp -H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":"1","method":"mcp.tools.list","params":{}}'
开发模式下启动服务器:
npm run start:dev
运行测试:
npm test