n8n MCP Server - MCP服务，MCP服务器，MCP教程

基本能力

产品定位

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 代理

安装教程

1. 安装包
   bash
npm install @dopehunter/n8n-mcp-server

2. 创建 .env 文件
   bash
cp .env.example .env

3. 配置 n8n 连接
   编辑 .env 文件并设置:

4. N8N_BASE_URL: 你的 n8n 实例 URL (例如 http://localhost:5678/api)

5. N8N_API_KEY: 你的 n8n API 密钥 (在 n8n 设置中生成)

6. 启动服务器
   bash
npm start

调试方式

测试服务器是否正常运行:
bash
curl -X POST http://localhost:3000/mcp -H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":"1","method":"mcp.tools.list","params":{}}'

开发模式下启动服务器:
bash
npm run start:dev

运行测试:
bash
npm test