leonardosepulvedat/mcp-n8n

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

21 stars 3 forks 质量 85 趋势 30MIT

Repository Install

Claude桌面和光标的完整n8n API集成——100个工作流模板，智能匹配

概览

— 实例管理（用户、项目、执行、审计）完整的构建循环：官方N8N包提取目录、保存前验证、自动修复、带回滚和差值的快照、逐节点执行调试、健康报告和完整实例备份。两个环境变量。运行在你的机器（stdio）或远程HTTP服务器上。没有托管账户。解决了MCP服务器最大的问题之一——过度使用API令牌。 - 用于新n8n_list_workflows_summary端点工作流列表的令牌 - - 只请求你需要的数据 - - 每次查询结果从100减少到10-20个 - - 当操作消耗大量令牌时发出警报 - ：构建带有自然语言描述的工作流程 - ：完整的生命周期管理（创建、读取、更新、删除） - ：按需启用/禁用工作流程 - ：无缝地在项目间移动工作流程 - ：用自定义标签组织工作流程 - ：用高级过滤器监控工作流执行 - ：...

概述（AI 翻译）

从 Cursor 或 Claude 操作并构建 n8n — 管理你的实例（用户、项目、执行、审计）** 以及完整的构建循环：包含560个节点目录，包含真实参数模式**，从官方 n8n 包中提取，保存前验证，自动修复，带回滚和差异的快照，逐节点执行调试，健康报告和完整实例备份。

两个环境变量。运行在你的机器（stdio）或远程HTTP服务器上。没有托管账户。

🎯 代币优化

该服务器优化以最小化令牌消耗，解决了MCP服务器最大的问题之一——API令牌使用过度。

我们优化的内容：

**在新n8n_list_workflows_summary端点下，工作流列表的令牌减少90%
字段过滤 - 仅请求所需的数据
智能默认 - 每次查询结果由100减少到10-20条
智能警告——当操作将消耗大量令牌时发出警报

详见TOKEN_OPTIMIZATION.md的详细使用指南。

✨ 特色

🔄 工作流程管理

创建与部署：构建带有自然语言描述的工作流程

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

MCP n8n Server

Operate and build n8n from Cursor or Claude — administration of your instance (users, projects, executions, audit) and a full builder loop: a catalog of 560 nodes with real parameter schemas extracted from the official n8n packages, validation before saving, automatic repair, snapshots with rollback and diff, per-node execution debugging, health reports, and full-instance backup.

Two env vars. Runs on your machine (stdio) or as a remote HTTP server. No hosted account.

🎯 Token Optimization

This server is optimized to minimize token consumption, addressing one of the biggest issues with MCP servers - excessive API token usage.

What We’ve Optimized:

90% reduction in tokens for workflow listing with new n8n_list_workflows_summary endpoint
Field filtering - request only the data you need
Smart defaults - reduced from 100 to 10-20 results per query
Intelligent warnings - alerts when operations will consume significant tokens

See TOKEN_OPTIMIZATION.md for detailed usage guide.

✨ Features

🔄 Workflow Management

Create & Deploy: Build workflows with natural language descriptions
CRUD Operations: Full lifecycle management (Create, Read, Update, Delete)
Activation Control: Enable/disable workflows on demand
Project Transfer: Move workflows between projects seamlessly
Tag Management: Organize workflows with custom tags

📊 Execution Monitoring

Real-time Tracking: Monitor workflow executions with advanced filters
Detailed Insights: Access full execution data and logs
Error Recovery: Retry failed executions automatically
Cleanup Tools: Manage execution history efficiently

🔐 Credential Management

Secure Creation: Add credentials for any service
Schema Discovery: Auto-discover required fields for credential types
Project Isolation: Transfer credentials between projects safely
Type Support: Compatible with all n8n credential types

🧱 Workflow Builder

在 GitHub 查看完整 README

安装

npx -y mcp-n8n

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "n8n": {
      "command": "mcp-n8n",
      "env": {
        "N8N_BASE_URL": "https://your-n8n-instance.com",
        "N8N_API_KEY": "your-api-key-here",
        "N8N_TOOLSETS": "all"
      }
    }
  }
}