2026年3月更新 MCP 集成 2026 新功能

Dify + MCP 指南 2026:将 AI 智能体连接到任意工具

Model Context Protocol(MCP)是连接 AI 模型与外部工具的新通用标准。本指南向您展示如何在 Dify 中集成 MCP 服务器 — 让您的智能体可以访问文件系统、GitHub、Slack、数据库和任意 API。

在 Hetzner 上托管 Dify → 在 Elestio 一键部署

什么是 MCP(Model Context Protocol)?

Model Context Protocol(MCP)是 Anthropic 于 2024 年底发布的开放标准。它定义了 AI 语言模型如何与外部工具和数据源连接。此前,每个 AI 平台需要为每个工具单独开发集成 — GitHub 连接器、数据库适配器、文件读取器,各自独立开发。MCP 从根本上改变了这一局面。

最佳比喻:MCP 就像AI 的 USB-C。就像 USB-C 允许任何设备连接到任何计算机一样,MCP 让任何 AI 智能体都能连接到任何兼容 MCP 的工具服务器。一个标准,无限扩展性。

技术背景:MCP 使用基于 HTTP 或 stdio 的客户端-服务器架构。AI 智能体(客户端)向 MCP 服务器发送请求,服务器提供"工具"— 智能体可以调用的函数。该协议与语言无关:服务器可以用 Node.js、Python、Go 或任何其他语言编写。

标准化

一个协议适用所有工具。一次构建,随处连接。

开源

Apache-2.0 许可。社区驱动的服务器生态系统。

安全

服务器在本地或私有网络运行。您的数据留在您这里。

可扩展

为任意 API、数据库或服务构建自己的 MCP 服务器。

Dify 作为 MCP 客户端

Dify 原生支持作为客户端使用 MCP。这意味着:您的 Dify 智能体可以直接与任何 MCP 服务器通信。当您向 Dify 添加 MCP 服务器时,Dify 自动识别所有提供的工具并使其在您的智能体应用中可用。您的 AI 智能体自主决定何时调用哪些工具。

这比传统 API 集成有了显著进步。不再需要在 Dify 中为每个 API 单独创建"自定义工具"条目,只需将 Dify 指向一个 MCP 服务器 — 完整的工具目录会自动加载。添加 GitHub MCP 服务器,您的智能体就能立即列出仓库、读取文件、创建 Issue 和审查 Pull Request。

通过 MCP 可以连接什么

📁
本地文件系统
读写服务器上的文件。非常适合文档处理。
🐙
GitHub
仓库、分支、PR、Issues、代码搜索、提交历史。
💬
Slack
读取和发送消息、列出频道、搜索对话历史。
🐘
PostgreSQL
执行只读 SQL 查询、浏览 Schema、分析数据。
🔍
网络搜索
通过 Brave Search 或 DuckDuckGo API 进行实时网络搜索。
🌐
Puppeteer
浏览器自动化 — 导航页面、提取内容、截图。

将 MCP 服务器连接到 Dify — 分步说明

在 Dify 中添加 MCP 服务器作为工具大约需要 2 分钟。以下是完整流程:

1

启动 MCP 服务器

在本地或服务器上启动 MCP 服务器。官方 Anthropic 文件系统服务器示例:npx @modelcontextprotocol/server-filesystem /path/to/your/files — 在 3000 端口启动 HTTP MCP 服务器。

2

打开 Dify 工具

在 Dify 中点击顶部导航的"工具",然后在左侧面板点击"自定义工具"。

3

创建新 MCP 工具

点击"+ 创建"。工具类型选择"MCP Server"(而非 OpenAPI)。

4

输入 MCP 服务器 URL

粘贴您的 MCP 服务器 URL,例如 http://localhost:3000/mcp 或 http://your-server-ip:3000/mcp。如果服务器需要认证,在 Authorization Header 字段填写认证令牌。

5

自动发现

Dify 自动加载服务器的工具清单。您将看到所有提供的工具列表 — 例如文件系统服务器的"read_file"、"list_directory"、"write_file"。

6

添加到智能体应用

在 Dify 中打开或创建智能体应用。在"工具"部分点击"添加工具"并选择您的 MCP 服务器。您的智能体现在可以使用所有识别到的工具了。

自托管注意事项:如果 Dify 和 MCP 服务器运行在同一主机上,请使用服务器的内部 IP 或主机名 — 而非 localhost,因为 Dify 在 Docker 中运行。例如使用:http://172.17.0.1:3000/mcp 或在 macOS/Windows 上使用 http://host.docker.internal:3000/mcp。

Dify 的常用 MCP 服务器

Anthropic 和社区维护着不断增长的 MCP 服务器生态系统。以下是对 Dify 最实用的服务器:

MCP 服务器 功能 主要工具 安装
filesystem 读写本地文件 read_file, write_file, list_directory, search_files npx @modelcontextprotocol/server-filesystem
github GitHub 仓库、PR、Issues get_file_contents, create_issue, list_pull_requests, search_code npx @modelcontextprotocol/server-github
slack Slack 消息和频道 list_channels, get_messages, send_message, search_messages npx @modelcontextprotocol/server-slack
postgresql 只读 SQL 数据库访问 query, list_tables, describe_table npx @modelcontextprotocol/server-postgres
brave-search 实时网络搜索 brave_web_search, brave_local_search npx @modelcontextprotocol/server-brave-search
puppeteer 浏览器自动化和爬虫 navigate, screenshot, get_content, click, fill npx @modelcontextprotocol/server-puppeteer

设置 MCP 服务器:分步示例

完整示例:设置 Anthropic Filesystem MCP 服务器,让您的 Dify 智能体能够读写服务器上的文件。

步骤 1:安装 Node.js 18+(如已安装请跳过)

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo bash -
sudo apt-get install -y nodejs

步骤 2:启动 Filesystem MCP 服务器

npx @modelcontextprotocol/server-filesystem /home/user/documents

# 服务器运行在 http://localhost:3000/mcp

步骤 3:作为后台服务运行(可选)

npm install -g pm2
pm2 start "npx @modelcontextprotocol/server-filesystem /home/user/documents" --name mcp-filesystem
pm2 save && pm2 startup

步骤 4:测试服务器

curl http://localhost:3000/mcp
# 预期输出:{"name":"filesystem","version":"...","tools":[...]}

步骤 5:GitHub MCP 服务器(带认证)

GITHUB_PERSONAL_ACCESS_TOKEN=ghp_your_token_here \
  npx @modelcontextprotocol/server-github

# 在 github.com/settings/tokens 创建 GitHub PAT

实际使用场景

三个可立即复制的生产就绪 Dify + MCP 配置:

📄

使用场景 1:AI 文档助手

将 Filesystem MCP 服务器连接到 Dify 智能体。AI 智能体现在可以搜索您的文档文件夹、阅读合同、提取关键数据、比较版本并将摘要写回 — 全部通过自然语言完成。"总结 /reports/Q1 中的所有 PDF 报告并生成管理摘要"— 即刻生效。

MCP 服务器:filesystem Dify 应用:智能体 模型:Claude 3.5 Sonnet 或 GPT-4o
🐙

使用场景 2:GitHub PR 审查器

将 GitHub MCP 服务器连接到 Dify。构建自动审查 Pull Request 的智能体:列出开放的 PR、读取 diff、检查代码规范、识别潜在 bug 并发布审查评论 — 全在 Dify 界面内完成。通过 Dify 工作流定时运行,实现自动代码审查。

MCP 服务器:github Dify 应用:工作流 + 智能体 需要:GitHub PAT Token
🐘

使用场景 3:数据库分析师

将 PostgreSQL MCP 服务器以只读凭证连接到 Dify。构建自然语言数据分析师:用户用中文提问业务问题,智能体编写 SQL 查询、对数据库执行查询并以易读格式返回洞察。用户无需了解 SQL。

MCP 服务器:postgresql Dify 应用:聊天机器人 安全:只读数据库用户

常见问题

什么是 MCP(Model Context Protocol)?

MCP 是 Anthropic 发布的开放标准,定义 AI 模型如何与外部工具和数据源连接。可以将其视为'AI 的 USB-C'— 而非为每个工具单独集成,一个标准可在所有地方工作。Dify 支持 MCP 作为客户端。

通过 MCP 可以将什么连接到 Dify?

通过 MCP,您可以将 Dify 连接到:本地文件系统、GitHub(仓库、PR、Issues)、Slack(消息、频道)、PostgreSQL 数据库、网页浏览器(Puppeteer)、网络搜索(Brave、DuckDuckGo)以及任何有 MCP 服务器的服务。

使用 Dify 的 MCP 需要编程知识吗?

对于官方 MCP 服务器(Filesystem、GitHub 等),只需一条 npx 命令即可启动,然后在 Dify 中输入 URL。无需编码。构建自己的 MCP 服务器需要基本的 Node.js 或 Python 知识。

MCP 适合生产环境使用吗?

MCP 安全性取决于您的服务器配置。始终在 localhost 或私有网络上运行 MCP 服务器 — 绝不要直接暴露在互联网上。使用认证令牌并将文件访问限制在特定目录。

在生产环境中运行 Dify + MCP?

MCP 在 Dify 和 MCP 服务器共同自托管时发挥最大效能 — 在同一私有服务器上,数据不会离开自己的基础设施。Hetzner 提供 €3.79/月起的 VPS,性能足以同时运行 Dify 和多个 MCP 服务器。或使用 Elestio 进行完全托管的一键 Dify 部署。

在 Hetzner 部署(€3.79/月起)→ 在 Elestio 一键部署 比较所有托管选项