基本能力
产品定位
n8n-mcp-server 是一个为 n8n 自动化平台设计的 Master Control Program (MCP) 服务器,旨在提供工作流验证、NextJS 集成和工作流管理等功能,以提升 n8n 项目的质量和开发效率。
核心功能
- 工作流验证:检查工作流是否符合最佳实践,包括命名约定、错误处理、安全性、性能和文档。
- NextJS 集成:为 n8n 工作流生成 NextJS 集成,包括自动生成 API 路由、OpenAPI/Swagger 文档、TypeScript 类型和 API 客户端。
- 工作流管理:提供工作流的列表、获取、创建、更新、删除、导出和导入功能。
- n8n API 访问:直接访问 n8n API 进行高级操作。
- 工作流模板:提供预定义的工作流模板,如 Google Calendar 模板。
适用场景
- 自动化工作流的验证和质量控制。
- 将 n8n 工作流集成到 NextJS 应用中。
- 管理和维护大量的 n8n 工作流。
- 快速启动新项目使用预定义的工作流模板。
工具列表
- N8nApiTool:直接与 n8n API 交互。
- WorkflowManagerTool:管理 n8n 工作流(列表、获取、创建、更新、删除、导出、导入)。
- NextJSIntegrationTool:为 n8n 工作流生成 NextJS 集成。
- WorkflowValidatorTool:根据多种标准验证 n8n 工作流。
常见问题解答
- 如何配置 n8n API 连接?:通过修改
.env
文件中的环境变量来配置 n8n API 连接。 - 如何启动服务器?:运行
pnpm start
命令启动服务器。 - 如何与 Claude Desktop 集成?:通过配置
claude_desktop_config.json
文件来实现集成。
使用教程
使用依赖
- Node.js (v16 或更高版本)
- pnpm (v7 或更高版本)
- n8n 实例 (本地或远程)
安装教程
- 克隆仓库或导航到项目文件夹。
- 安装依赖:
bash
pnpm install - 配置环境变量:
bash
cp .env.example .env - 修改
.env
文件以包含您的 n8n API 连接信息。
调试方式
- 构建项目:
bash
pnpm build - 启动服务器:
bash
pnpm start - 服务器将在 http://localhost:3000 或
.env
文件中指定的端口上运行。