MCP服务器用于n8n

此项目是一个MCP（主控程序）服务器，用于n8n，提供工作流验证工具和良好实践，适用于您的n8n自动化项目。

功能

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

预备条件

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

安装

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",
  3. "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"
}

贡献

欢迎贡献！请随时打开问题或拉取请求。

许可证

MIT