Dify MCP Server 插件使用指南
MCP Server 是 Dify 社区贡献的 Extension 类型插件,安装后可将任何 Dify 应用转换为符合 MCP 标准的 Server Endpoint,供外部 MCP 客户端直接访问。
主要功能
- 暴露为 MCP 工具:将 Dify 应用抽象为单一 MCP 工具,供外部 MCP 客户端(如 Cursor、Claude Desktop、Cline 等)调用。
- 利用 Dify Endpoint 功能:用户创建应用 Endpoint 后,将获得唯一的 URL,外部 MCP 客户端可直接通过该 URL 连接。
- 提供 MCP 服务:插件在 Dify 插件环境中自动启动 HTTP 服务,基于 HTTP 和 SSE 协议,高效处理外部 MCP 客户端请求,包括协议握手、能力发现以及工具调用。
配置步骤
1. 安装插件
在 Dify 插件市场中搜索并安装 mcp-server 插件。安装成功后可在插件列表中查看。
2. 修改环境变量
由于该工具需对外提供服务,需修改 Dify 的 .env 文件,将本地地址替换为局域网或公网 IP。可参考官方示例文件:
https://github.com/langgenius/dify/blob/main/docker/.env.example
找到以下配置项进行修改:
PLUGIN_DEBUGGING_HOST=0.0.0.0
PLUGIN_DEBUGGING_PORT=5003
EXPOSE_PLUGIN_DEBUGGING_HOST=your_public_ip
EXPOSE_PLUGIN_DEBUGGING_PORT=5003
# If this key is changed, DIFY_INNER_API_KEY in plugin_daemon service must also be updated or agent node will fail.
PLUGIN_DIFY_INNER_API_KEY=<YOUR_KEY>
PLUGIN_DIFY_INNER_API_URL=http://api:5001
ENDPOINT_URL_TEMPLATE=http://your_public_ip/e/{hook_id}
注意:
- 将
EXPOSE_PLUGIN_DEBUGGING_HOST中的localhost替换为你的公网 IP 或局域网 IP。 - 确保
PLUGIN_DIFY_INNER_API_KEY与plugin_daemon服务中的一致。 ENDPOINT_URL_TEMPLATE中的地址也需对应修改为可访问的 IP 地址。
完成上述配置后重启 Dify 服务即可生效。


