# 快速创建 MCP 服务（用 n8n 几分钟搞定）
> 本文由真人手搓，经过AI润色

## 前言：为什么要"快速"创建 MCP

MCP（Model Context Protocol）在 agent 访问特定资源时非常重要。

它能把企业/系统内部的资源转换成 agent 可以访问的数据，从而自动化完成一些事情，大大降低人力成本。

而且 MCP 方式对比线上直连数据库要安全很多——直连意味着 agent 拿到的是一张"任意 SQL 的通行证"，慢查询、越权读、误写删都可能发生；

MCP 则把可执行的动作收敛成一个个"工具"，参数受控、SQL 写死、调用可审计。

改造前后对比如下：

```
【改造前】风险直连
   ┌─────────┐   任意 SQL / 写操作    ┌────────────┐
   │  Agent  │ ────────────────────▶ │  生产 DB   │
   └─────────┘   慢SQL·越权·误写      └────────────┘

【改造后】n8n 能力网关
   ┌─────────┐  MCP调用(工具名+参数)  ┌──────────────────────────┐  写死的只读SQL  ┌────────────┐
   │  Agent  │ ─────────────────────▶ │   n8n MCP Server         │ ─────────────▶ │  生产 DB   │
   └─────────┘   仅能传 uid 等参数     │  · 鉴权(Bearer)          │   参数化查询    └────────────┘
                                       │  · 固定SQL/白名单         │
                                       │  · 每次调用可审计         │
                                       └──────────────────────────┘
```

但现实是，创建一个 MCP 的门槛比较高：要选 SDK、要写 server 代码、要处理传输层、还要持续维护。那有没有一种非常快速的方式，几分钟内就拉起一个稳定的 MCP 服务供 agent 访问？

有，这就是 n8n。

---

## n8n 简介

n8n 是一个开源的工作流自动化平台，用"节点 + 连线"的拖拽方式编排自动化流程，支持几百种系统对接，也能自部署，数据不出自己的基础设施。

选它来建 MCP 服务，主要是三个原因：

1. **不用写 server 代码**：n8n 内置了 `MCP Server Trigger` 节点，配一下就生成一个标准 MCP 端点，省掉了协议实现那一摊。
2. **能力即工作流**：每个"工具"本质是一个子工作流，查库、调接口、做转换都能用现成节点拼，改逻辑不用动 server。
3. **自部署可控**：跑在自己的机器/云上，鉴权密钥、数据流向都握在自己手里，符合企业安全要求。

> 适用场景：给 agent 提供一批只读查询能力（查用户信息、查订单、查业务指标），把"能做什么"收口在 n8n，而不是把 DB 账号直接丢给 agent。

![Xnip2026-08-26_20-30-25.jpg](https://developer.qcloudimg.com/http-save/yehe-1367556/a17ed71d0d96e3ef256a16e58320dcb8.jpg)

---

## 整体架构

整个链路其实很清晰：

```
Agent  ──MCP调用(工具名+参数)──▶  MCP Server Trigger  ──Call Workflow──▶  查询子工作流  ──只读SQL──▶  DB
                                    (对外端点+鉴权)        ($fromAI传参)      (写死SQL/白名单)
```

- **MCP Server Trigger 工作流**：对外暴露端点，负责鉴权、把请求路由到对应工具。
- **查询子工作流**：真正干活的，接收入参、跑写死的只读 SQL、返回结构化结果。
- **安全边界**：agent 只能"选工具 + 传几个参数"，SQL 是预先写死的、只读的，没有注入空间。

---

## 搭建 MCP Server

### 1. 建查询子工作流

新建一个工作流，用 `Execute Workflow` 触发器接收入参（如 `uid`），内部节点执行**写死的只读 SQL**，返回结果。这个工作流需处于 `Active` 状态，否则上层调不动。
![image.jpg](https://developer.qcloudimg.com/http-save/yehe-1367556/5b473e7c97579357d61941f36bce8bb8.png)
### 2. 建 MCP Server 工作流

新建工作流，加入 `MCP Server Trigger` 节点。它会生成一个对外的 MCP 端点 URL（路径即节点的 webhook path）。
![image (1).jpg](https://developer.qcloudimg.com/http-save/yehe-1367556/115888f1dab25a96af7a78fe8a084409.png)
### 3. 挂载工具

在 MCP Server Trigger 的 Tools 上，添加 `Call Workflow（toolWorkflow）` 节点，指向第 1 步的子工作流；参数用 `$fromAI('uid', '', 'number')` 让 agent 传值。

> `$fromAI(参数名, 描述, 类型)` 这段描述会作为工具入参说明传给 agent，写得越准，agent 调得越对。

### 4. 加鉴权

把 MCP Server Trigger 的 Authentication 设为 `Bearer Auth`，配置一个密钥。agent 端请求时带上 `Authorization: Bearer <密钥>` 才能访问。



### 5. 发布

保存并发布（`Active`）工作流，端点才会生效。**注意：Save 只是存草稿，不发布线上跑的还是旧版本。**

---

## 两个必踩的坑（血泪教训）

### 坑 1：工具节点必须用唯一的英文名

若用中文名，n8n 生成 MCP 工具名时会把非 ASCII 字符全部剥离 → 多个中文名工具全部塌缩成 `_` → 工具名冲突 → MCP Server 直接启动失败（HTTP 500）。

比如叫 `查询用户信息`，剥完可能只剩 `_`，再叫个 `查询订单` 也变 `_`，俩就打架了。老老实实用 `query_user_info`、`query_order` 这种英文名。

### 坑 2：改完必须"发布"

仅 Save 只是存草稿，线上跑的仍是旧的 active 版本，改动不生效。改完一定记得点 Active 发布。

### 建议：给每个工具节点填清晰的 description

这段描述会作为工具说明传给 agent，写得越准，agent 用得越对。例如：

> "查询用户对某部剧的观看记录，入参 uid 和 theater_id"

而不是干巴巴写个 "查询"。

---

## 在 Agent 端接入

### Cursor

在 `~/.cursor/mcp.json` 的 `mcpServers` 中加入一个 server：

```json
{
  "mcpServers": {
    "xxx-user-query": {
      "type": "http",
      "url": "https://workflows.xxx.com/mcp/fd5fd757-df3e-4c30-95fb-a8353cb8e054",
      "headers": {
        "Authorization": "Bearer xxx"
      }
    }
  }
}
```

### 飞书智能体接入

飞书智能体（扣子 / 多 agent 平台）同样支持把 MCP 端点作为"工具"挂载，配置端点 URL + Bearer 密钥即可，接入方式和 Cursor 思路一致：URL + 鉴权头。


### 加载与刷新注意

| 操作 | 是否需要重连 | 说明 |
|---|---|---|
| 新增/删除工具、改工具名或入参 | 需要 | 工具签名变了，客户端缓存需刷新 |
| 仅改已有工具的 SQL/逻辑 | 不需要 | 签名不变，调用走 n8n 最新发布逻辑 |

---

## 效果

接入飞书智能体后，agent 就能远程执行一些只读查询操作了——比如问"用户 123 看过哪些剧"，agent 自动调对应工具拿数、组织回答，不用人工跑 SQL 再贴回来，确实省了人力。
![image (2).jpg](https://developer.qcloudimg.com/http-save/yehe-1367556/43eca968ad6568958f7f714d9b4245dc.png)

---

## 总结

用 n8n 搭 MCP，核心就一句话：**把"能力"收口成工作流，agent 只能选工具 + 传参数，SQL 写死、只读、可审计。**

回看解决了三个问题：

1. **门槛高** → 不用写 server 代码，拖几个节点就出一个标准 MCP 端点。
2. **不安全** → agent 不再直连 DB，能力边界由 n8n 工作流定义。
3. **维护重** → 改逻辑改工作流即可，发版走 n8n 的 Active，不用重新部署服务。

两个一定记住的点：工具名用英文、改完要发布。

---

MCP（Model Context Protocol）在 agent 访问特定资源时非常重要。

快速创建 MCP 服务（用 n8n 几分钟搞定）

十倍工程师

开发工具

后端

人工智能

本文介绍如何用n8n快速搭建MCP服务，将Agent对数据库的访问收敛为可控工具调用，避免直连风险。通过MCPServerTrigger节点配合子工作流，无需编写Server代码即可实现鉴权、只读SQL及审计能力。文中涵盖搭建步骤、常见坑点及Cursor/飞书智能体接入方式，为企业安全开放数据访问提供低门槛方案。

代码解释

数据库

数据流

智能体

路由

Agent

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

快速创建 MCP 服务（用 n8n 几分钟搞定）-腾讯云开发者社区-腾讯云

快速创建 MCP 服务（用 n8n 几分钟搞定）

快速创建 MCP 服务（用 n8n 几分钟搞定）

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐