N8n Server
MCP (Master Control Program) 服务器为n8n提供工作流验证工具和自动化项目最佳实践
概述
n8n的MCP服务器
该项目是n8n的MCP（主控程序）服务器，为您的n8n自动化项目提供工作流验证和最佳实践工具。
功能特性
- 工作流验证：检查您的工作流是否符合最佳实践
- 命名规范
- 错误处理
- 安全性
- 性能
- 文档
- NextJS集成：为您的n8n工作流生成NextJS应用集成
- 自动生成API路由
- 创建OpenAPI/Swagger文档
- 生成TypeScript类型
- 便于集成的API客户端
- 工作流管理：与n8n工作流交互（列表、获取、创建、更新、删除、导出、导入）
- n8n API：直接访问n8n API进行高级操作
- 工作流模板：使用现成模板应对不同用例，特别是Google Calendar
先决条件
- Node.js（v16或更高）
- pnpm（v7或更高）
- n8n实例（本地或远程如n8n.bienquoi.com上的Cloudron实例）
安装
- 克隆此仓库或导航至项目目录
- 安装依赖：
bash
pnpm install- 配置环境变量：
bash
cp .env.example .env修改.env文件中的n8n API连接信息。
使用说明
项目构建
bash
pnpm build启动服务器
bash
pnpm startMCP服务器将在http://localhost:3000（或.env文件中指定的端口）可访问。
与Claude Desktop配合使用
要在Claude Desktop中使用此MCP服务器，需在%APPDATA%/Claude/目录下配置claude_desktop_config.json文件：
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交互。
typescript
// 使用示例
{
"method": "GET",
"endpoint": "/workflows",
"params": "?active=true"
}2. WorkflowManagerTool
管理n8n工作流（列表、获取、创建、更新、删除、导出、导入）。
typescript
// 使用示例
{
"action": "list",
"tags": "production"
}3. NextJSIntegrationTool
为n8n工作流生成NextJS集成。
typescript
// 使用示例
{
"workflowId": "123",
"outputDir": "./my-nextjs-app/pages/api",
"generateTypes": true,
"generateOpenAPI": true
}4. WorkflowValidatorTool
根据不同标准验证n8n工作流。
typescript
// 使用示例
{
"workflow": "{...}",
"validators": ["naming", "errorHandling", "security"],
"strictness": "high"
}贡献指南
欢迎贡献！请随时提交issue或pull request。
许可协议
MIT