Dify+DeepSeek+MCP：从入门到精通，手把手教你将工作流秒变智能工具

作者：码力金矿
作为AI开发者，你是否遇到过这样的问题：辛辛苦苦搭建好的Dify工作流，却只能在本地使用，无法快速复用到其他场景？今天，我们将通过MCP（模型上下文协议）协议，教你将Dify工作流转化为可调用的MCP工具，实现跨平台复用。本文将从零开始，分三步带你完成这一目标！

---

一、Dify工作流发布为工具
目标：将Dify工作流转换为可调用的API工具。
操作步骤：

• 进入Dify控制台
  登录某Dify平台，进入“应用管理”页面，选择已搭建好的工作流（例如“生成天气邮件”），点击“发布工具”。
  
• 配置工具参数
  
  工具名称：输入工具的唯一标识（如weather_email_generator）。工具描述：简要说明工具功能（如“支持生成带城市天气的邮件内容”）。输入参数：定义工具接收的参数类型（例如：city为必填文本字段，subject为可选文本字段）。
  
  
  
• 生成工具ID
  发布完成后，系统会生成一个工具ID（如tool_12345），记录此ID用于后续调用。
  关键点：
  

参数需与工作流输入字段严格一致，否则调用时会报错。工具名称建议使用英文或下划线，避免特殊字符。

---

二、安装配置MCP Server插件
目标：通过插件将Dify工具暴露为MCP服务。
操作步骤：

• 安装MCP Server插件
  在Dify插件市场搜索“MCP Server”，安装社区提供的插件（如“MCP-Server-Extension”）。
  
• 配置插件参数
  进入插件配置页面，填写以下JSON结构：
  1. {"端点名称":"天气邮件工具","App":"weather_email_generator",// 工作流名称"App Type":"Workflow","App Input Schema":{"type":"object","properties":{"city":{"type":"string","description":"城市名称"},"subject":{"type":"string","description":"邮件主题"}},"required":["city"]}}

  复制代码
• 修改环境变量
  找到Dify的.env文件，将EXPOSE_PLUGIN_DEBUGGING_HOST和ENDPOINT_URL_TEMPLATE中的localhost改为服务器IP，确保外部可访问。
  关键点：
  

App Input Schema需与工作流输入参数完全一致，否则调用失败。若使用私有网络，需开放服务器IP的端口（如5003）。

---

三、获取MCP链接并调用
目标：让其他工具（如某Cursor、某DeepSeek）调用你的Dify工作流。
操作步骤：

• 生成MCP服务地址
  配置完成后，插件会生成一个URL（如https://your-server.com/sse），复制此链接。
  
• 在外部工具中调用
  以某Cursor为例，在其MCP配置中添加：
  1. {"mcpServers":{"weather_email":{"url":"https://your-server.com/sse"}}}

  复制代码
• 测试调用
  输入“生成北京天气邮件”，AI会自动调用你的Dify工具，返回邮件内容。
  案例实战：
  场景：用户说“发一封明天北京天气的会议提醒邮件”。
  MCP流程：意图识别：AI解析出“天气查询”和“邮件生成”需求。
  
• 工具调用：
  
  调用Dify的天气API工具获取数据。调用已发布的邮件生成工具，填入数据。
  
  结果整合：生成邮件并返回。
  

---

四、技术进阶：MCP的隐藏优势

• 跨平台复用
  同一工具可被某DeepSeek、某Cherry Studio等调用，无需重复开发。
  
• 动态参数
  支持根据用户输入动态调整参数（如自动补全城市名称）。
  
• 安全可控
  通过JWT令牌限制调用权限，防止未授权访问。
  

---

五、常见问题与解决方案
问题1：调用时提示“NoneType对象错误”。
解决：

检查工作流输入参数是否与MCP配置一致。

• 确认服务器IP和端口已开放。
  问题2：外部工具无法连接MCP服务。
  解决：确保Dify服务已重启（命令：docker compose -p dify down && docker compose -p dify up）。使用Postman测试MCP URL是否返回有效数据。
  

---

六、总结
通过MCP协议，Dify工作流不再是“一次性工具”，而是成为可复用的“AI积木”。无论是个人开发者还是企业团队，都能快速构建高效协作的AI生态。只需三步操作，即可将你的工作流能力扩展到其他平台，实现真正的“效率开挂”！
提示：若需进一步优化，可结合JWT鉴权、日志记录等功能，提升服务安全性与可维护性。




原文地址：https://blog.csdn.net/lbh73/article/details/148898965