Dify + MCP 指南 2026:将 AI 智能体连接到任意工具
Model Context Protocol(MCP)是连接 AI 模型与外部工具的新通用标准。本指南向您展示如何在 Dify 中集成 MCP 服务器 — 让您的智能体可以访问文件系统、GitHub、Slack、数据库和任意 API。
什么是 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 可以连接什么
将 MCP 服务器连接到 Dify — 分步说明
在 Dify 中添加 MCP 服务器作为工具大约需要 2 分钟。以下是完整流程:
启动 MCP 服务器
在本地或服务器上启动 MCP 服务器。官方 Anthropic 文件系统服务器示例:npx @modelcontextprotocol/server-filesystem /path/to/your/files — 在 3000 端口启动 HTTP MCP 服务器。
打开 Dify 工具
在 Dify 中点击顶部导航的"工具",然后在左侧面板点击"自定义工具"。
创建新 MCP 工具
点击"+ 创建"。工具类型选择"MCP Server"(而非 OpenAPI)。
输入 MCP 服务器 URL
粘贴您的 MCP 服务器 URL,例如 http://localhost:3000/mcp 或 http://your-server-ip:3000/mcp。如果服务器需要认证,在 Authorization Header 字段填写认证令牌。
自动发现
Dify 自动加载服务器的工具清单。您将看到所有提供的工具列表 — 例如文件系统服务器的"read_file"、"list_directory"、"write_file"。
添加到智能体应用
在 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 报告并生成管理摘要"— 即刻生效。
使用场景 2:GitHub PR 审查器
将 GitHub MCP 服务器连接到 Dify。构建自动审查 Pull Request 的智能体:列出开放的 PR、读取 diff、检查代码规范、识别潜在 bug 并发布审查评论 — 全在 Dify 界面内完成。通过 Dify 工作流定时运行,实现自动代码审查。
使用场景 3:数据库分析师
将 PostgreSQL MCP 服务器以只读凭证连接到 Dify。构建自然语言数据分析师:用户用中文提问业务问题,智能体编写 SQL 查询、对数据库执行查询并以易读格式返回洞察。用户无需了解 SQL。
常见问题
什么是 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 部署。