N8n MCP Claude

n8n mcp克劳德

连接的MCP服务器 Claude桌面应用程序 与当地人 n8n 例子搜索节点、编写工作流、管理凭据和存储结构化数据——所有这些都来自Claude。

它做什么

从Claude Desktop，您可以：

• 搜索 436+n8n节点自然语言编目
• 检查 任何节点的完整架构（参数、凭据、I/O）
• 编排 描述中的工作流（“按状态筛选并发送到Slack的webhook”）
• 部署 工作流程直接连接到您正在运行的n8n
• 浏览 经过验证的工作流模式和模板
• 创建凭据 用于API密钥、令牌和身份验证头
• 管理数据表 --n8n内置的用于结构化数据的SQLite数据库

设置

1.安装和构建

git clone https://github.com/MauricioPerera/n8n-mcp-claude.git
cd n8n-mcp-claude
npm install
npm run build

2.提取n8n节点定义

# From GitHub (no n8n instance needed)
node dist/cli/cli.js extract-github

# Or from your running n8n (gets full node schemas)
N8N_BASE_URL=http://localhost:5678 N8N_API_KEY=your-key node dist/cli/cli.js extract

3.种子工作流程模式

node dist/cli/cli.js seed

4.配置n8n连接

创建 .n8n-a2e/config.json 在项目根目录中：

{
  "baseUrl": "http://localhost:5678",
  "apiKey": "your-n8n-api-key"
}

5.连接到克劳德桌面应用程序

编辑文件 %APPDATA%\Claude\claude_desktop_config.json （Windows）或 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）：

{
  "mcpServers": {
    "n8n-a2e": {
      "command": "node",
      "args": ["C:\\path\\to\\n8n-mcp-claude\\dist\\mcp\\main.js"]
    }
  }
}

在Windows上使用双反斜杠。路径必须是绝对的。

重新启动Claude Desktop应用程序。MCP将出现在 桌面 下节 设置>连接器.

MCP工具（19）

节点目录

工作流生命周期

凭证

数据表

Claude的用法

一旦连接，只需自然地与克劳德交谈：

创建和部署工作流

"What n8n nodes are available for sending Slack messages?"
"Compose a workflow that watches a webhook, filters by status, and sends to Slack"
"Deploy that workflow to my n8n and activate it"

管理和执行工作流

"What workflows are running in my n8n?"
"Execute the backup workflow now"
"Deactivate the test workflow"

凭证

"What credential types does n8n support for OpenAI?"
"Create an HTTP Header Auth credential named 'My API' with key X-Api-Key and value abc123"
"List all my configured credentials"

数据表

"Create a Data Table called 'Leads' with columns: name (string), email (string), score (number), qualified (boolean)"
"Insert 5 sample leads into the Leads table"
"Show me all rows in the Leads table"

为Claude创建工具（工作流即工具）

"Create a workflow with a webhook trigger that pushes a file to my GitHub repo"
"Create a cron workflow that moves files from Downloads to D:\backup every Monday at 8am"
"Create a webhook workflow that sends a message to Slack"

一旦部署了带有webhook触发器的工作流，Claude就可以通过以下方式执行它 execute_workflow，有效地将n8n工作流用作自定义工具。

Claude将自动使用MCP工具。

凭据管理

MCP可以创建 API密钥和基于令牌的凭据 直接：

• openAiApi --要求 apiKey
• slackApi --要求 accessToken
• httpHeaderAuth --要求 name （标题名称）和 value
• httpBasicAuth --要求 user 和 password
• notionApi --要求 apiKey
• n8n实例支持的任何非OAuth凭据类型

限制： OAuth凭据（Gmail、Google Drive、Slack OAuth）需要浏览器授权流程，不能通过API创建。使用n8n UI。

使用 get_credential_schema 在创建任何凭据类型之前，发现其所需的确切字段。

数据表

n8n数据表是一个内置的SQLite数据库（从n8n v1.113开始）。不需要外部数据库。

列类型： string, number, boolean, date

限制：

• 每个实例的总存储空间为50MB（可通过以下方式配置 N8N_DATA_TABLES_MAX_SIZE_BYTES)
• 默认查询限制：每个请求50行
• 50MB内存中可容纳约500000个简单行

启用数据表 （自托管）：

# If not already enabled
export N8N_ENABLED_MODULES=data-table

启用“执行命令”节点

n8n v2.0+默认情况下禁用“执行命令”节点。要启用它，请执行以下操作：

窗户（永久）：

setx NODES_EXCLUDE "[]"

Linux/macOS：

export NODES_EXCLUDE="[]"

设置变量后重新启动n8n。

运作原理

当您打开Claude Desktop时，MCP服务器会自动启动，无需手动启动。克劳德桌面阅读 claude_desktop_config.json，生成MCP进程，并通过stdio（JSON-RPC）进行通信。

离线工作的工具 （使用本地商店，不需要n8n）：

• search_n8n_nodes, get_node_details, list_workflow_patterns, generate_workflow_context, compose_workflow

需要n8n运行的工具：

• deploy_workflow, list_workflows, get_workflow, execute_workflow, activate_workflow, delete_workflow
• list_credentials, get_credential_schema, create_credential
• list_data_tables, create_data_table, get_data_table_rows, insert_data_table_rows, delete_data_table

建筑

Claude Desktop app
    ↓ (stdio MCP, JSON-RPC — auto-started)
n8n-mcp-claude server (19 tools)
    ├── Node catalog: search + inspect + patterns + context
    ├── Workflow lifecycle: compose → deploy → list → get → execute → activate → delete
    ├── Credentials: list → schema → create
    └── Data Tables: list → create → read → insert → delete
    ↓ (REST API)
n8n instance (localhost:5678)

工作流作为工具

作曲→ 部署→ execut cycle允许Claude创建n8n工作流，然后将其用作工具：

1. Claude编写了一个工作流（例如，“通过webhook将文件推送到GitHub”）
2. 在n8n中部署并激活它
3. 稍后，通过执行它 execute_workflow 输入数据

这将n8n变成 工具厂 --Claude可以根据需要构建自己的集成。

节点挖掘

服务器维护一个包含436+n8n个节点定义的本地存储，其中包括：

• 完整参数架构 --每个参数、类型、默认值、选项
• 证书要求 --每个节点需要什么身份验证
• 类别分类 --触发器、动作、转换、流、人工智能、效用
• TF-IDF搜索索引 --带词干和域扩展的自然语言搜索

刷新节点数据

# Re-extract from GitHub (updates to latest n8n nodes)
node dist/cli/cli.js extract-github

# Or from your instance (includes custom/community nodes)
node dist/cli/cli.js extract

# Check store stats
node dist/cli/cli.js stats

搜索是如何工作的

当你向克劳德询问n8n节点时 search_n8n_nodes 工具使用以下命令运行TF-IDF搜索：

• 波特堵塞 --“发送”匹配项“发送”，“已发送”
• 查询扩展 --“email”还搜索“gmail”、“smtp”、“imap”、“sendgrid”
• 标签增强 --标记有查询词的节点得分高1.3倍
• 50+停用词 过滤掉

环境变量

或使用 .n8n-a2e/config.json 而不是env变量。

需求

• Node.js 18+
• n8n在本地运行（用于部署、凭据和数据表）
• Claude桌面应用程序

许可证

麻省理工学院