n8n-mcp-server : outil de service MCP pour interagir avec les flux de travail n8n

Introduction générale

n8n-mcp-server 是一个开源项目，托管在 GitHub 上，由 Leonard Sellem 开发。它是一个 MCP（Model Context Protocol）服务工具，专门用来与 n8n 工作流交互。n8n 是一个自动化工作流平台，而这个工具通过 MCP 协议，让 AI 助手可以直接操作 n8n。你可以用它创建、运行和管理 n8n 工作流。它适合想通过 AI 简化自动化任务的人，比如开发者或团队。项目在 2025 年 3 月还有更新，说明它维护得不错。

Liste des fonctions

• 通过 MCP 协议连接 n8n，让 AI 助手直接控制工作流。
• 支持创建和修改 n8n 工作流。
• 可以运行 n8n 工作流并查看结果。
• 用环境变量配置 n8n 的连接信息。
• 开源设计，代码可以自由调整。

Utiliser l'aide

Étapes de l'installation

要用 n8n-mcp-server，你得先把它装好。以下是具体步骤：

1. 准备工具
   确保电脑上有 Node.js（建议版本 18 或更高）。你还需要一个运行中的 n8n 实例，并且打开了 API 功能。去 n8n 设置里找 API 密钥。
2. Télécharger le projet
   Saisissez-le dans le terminal :

git clone https://github.com/leonardsellem/n8n-mcp-server.git

Ensuite, consultez le catalogue :

cd n8n-mcp-server

3. Installation des dépendances
   运行这条命令：

npm install

它会装好项目需要的文件。

4. Définition des variables d'environnement
   Copiez le fichier d'exemple :

cp .env.example .env

spectacle (un billet) .env 文件，填入 n8n 的信息，比如：

N8N_API_URL=http://localhost:5678/api/v1
N8N_API_KEY=你的n8n密钥
DEBUG=false

• N8N_API_URL 是 n8n 的地址。
• N8N_API_KEY 是密钥。
• DEBUG mis en place en tant que true 可以看更多日志。

5. 编译代码
   Entrée :

npm run build

这会把代码转成可运行的文件。

6. Démarrage des services
   La course à pied :

npm start

服务就启动了，AI 助手可以通过标准输入输出跟它沟通。

Comment utiliser les fonctionnalités de base

装好后，n8n-mcp-server 就成了一个 MCP 服务。它的主要作用是让 AI 跟 n8n 工作流互动。以下是操作方法：

• 连接到 AI
  你得把这个服务加到 AI 平台。比如在支持 MCP 的工具里，编辑配置文件，加入：

{
"mcpServers": {
"n8n": {
"command": "n8n-mcp-server",
"env": {
"N8N_API_URL": "你的n8n地址",
"N8N_API_KEY": "你的密钥"
}
}
}
}

保存后，AI 就能找到这个服务。

• Création de flux de travail
  你可以对 AI 说：“帮我在 n8n 里建一个工作流，每天发邮件给我。” AI 会通过 MCP 服务，把请求发给 n8n，自动创建。
• Exécution de flux de travail
  说：“运行我的邮件工作流。” 服务会告诉 n8n 执行任务，然后返回结果，比如“任务完成”或“出错了”。
• 检查状态
  问：“我的工作流跑得怎么样了？” 服务会查 n8n 的状态，告诉你具体情况。
• Problèmes de débogage
  如果用着不对劲，把 .env 里的 DEBUG 改成 true，重启服务，就能看到详细日志。开发者还能改代码加功能。

pointe

• n8n 如果跑在本地，地址通常是 http://localhost:5678/api/v1.
• 密钥要保密，别随便给人看。
• 可以用 Docker 跑 n8n，配置方法跟 .env 差不多。

scénario d'application

1. 定时任务
   你可以用它做一个工作流，每天查天气然后发短信提醒。AI 通过服务直接搞定。
2. traitement des données
   在公司里，可以用它自动整理销售数据，生成表格发到群里。AI 操作，省时省力。
3. 测试开发
   开发者可以用它测试 AI 和 n8n 的配合，改代码试新想法。

QA

1. 我得会编程吗？
   不会也行，只要会用命令行装东西就够了。但改功能得懂 JavaScript。
2. 这个服务有啥特别的？
   它让 AI 能直接管 n8n 工作流，不用你手动点来点去。
3. 能连几个 n8n？
   随便几个。每个服务配一个 n8n 地址，跑多个实例就行。