用于 n8n 的 MCP 服务器

本项目是一个用于 n8n 的 MCP (Master Control Program) 服务器，它为您的 n8n 自动化项目提供工作流验证和最佳实践工具。

功能特性

• 工作流验证：验证您的工作流是否符合最佳实践
  • 命名约定
  • 错误处理
  • 安全性
  • 性能
  • 文档
• NextJS 集成：为您的 n8n 工作流在 NextJS 应用程序中生成集成
  • 自动生成 API 路由
  • 创建 OpenAPI/Swagger 文档
  • 生成 TypeScript 类型
  • API 客户端，方便集成
• 工作流管理：与您的 n8n 工作流交互（列表、检索、创建、更新、删除、导出、导入）
• n8n API：直接访问 n8n API 以进行高级操作
• 工作流模板：使用现成的模板用于不同的用例，特别是 Google 日历

前提条件

• Node.js (v16 或更高版本)
• pnpm (v7 或更高版本)
• 一个 n8n 实例（本地或远程，例如您在 n8n.bienquoi.com 上的 Cloudron 实例）

安装

1. 克隆此存储库或导航到项目文件夹
2. 安装依赖项：

pnpm install

3. 配置环境变量：

cp .env.example .env

修改 .env 文件，填写您的 n8n API 连接信息。

使用

构建项目

pnpm build

启动服务器

pnpm start

MCP 服务器将在 http://localhost:3000 (或您在 .env 文件中指定的端口) 上可用。

与 Claude Desktop 一起使用

要将此 MCP 服务器与 Claude Desktop 一起使用，您需要在 %APPDATA%/Claude/ 文件夹中配置 claude_desktop_config.json 文件：

{
  "mcpServers": {
    "n8n-mcp-server": {
      "command": "node",
      "args": ["/绝对/路径/到/mcp-n8n-server/dist/server.js"]
    }
  }
}

项目结构

mcp-n8n-server/
├── src/                    # 源代码
│   ├── tools/              # MCP 工具
│   │   ├── N8nApiTool.ts                # 用于与 n8n API 交互的工具
│   │   ├── WorkflowManagerTool.ts       # 用于管理工作流的工具
│   │   ├── NextJSIntegrationTool.ts     # 用于生成 NextJS 集成的工具
│   │   ├── WorkflowValidatorTool.ts     # 用于验证工作流的工具
│   │   └── ...
│   ├── validators/         # 工作流验证器
│   │   ├── naming.js       # 命名约定验证器
│   │   ├── errorHandling.js # 错误处理验证器
│   │   ├── security.js     # 安全性验证器
│   │   ├── performance.js  # 性能验证器
│   │   └── documentation.js # 文档验证器
│   ├── resources/          # 共享资源
│   └── server.ts           # 服务器入口点
├── dist/                   # 编译后的代码
├── public/                 # 静态文件
├── output/                 # 工具输出的目录
├── .env.example            # 配置文件示例
└── README.md               # 文档

可用工具

1. N8nApiTool

直接与 n8n API 交互。

// 使用示例
{
  "method": "GET",
  "endpoint": "/workflows",
  "params": "?active=true"
}

2. WorkflowManagerTool

管理 n8n 工作流（列表、检索、创建、更新、删除、导出、导入）。

// 使用示例
{
  "action": "list",
  "tags": "production"
}

3. NextJSIntegrationTool

为 n8n 工作流生成 NextJS 集成。

// 使用示例
{
  "workflowId": "123",
  "outputDir": "./my-nextjs-app/pages/api",
  "generateTypes": true,
  "generateOpenAPI": true
}

4. WorkflowValidatorTool

根据不同的标准验证 n8n 工作流。

// 使用示例
{
  "workflow": "{...}",
  "validators": ["naming", "errorHandling", "security"],
  "strictness": "high"
}

贡献

欢迎贡献！请随时打开 issue 或 pull request。

许可证

MIT