如何配置Dify中的MCP服务
——实现高效工具调用的完整指南
图:MCP在Dify中的工作流程
一、MCP服务核心价值
Dify 1.0的MCP工具代理策略通过两种传输协议实现强大的工具调用能力:
- SSE (Server-Sent Events):实时流式通信
- Streamable HTTP:高效分块传输
支持函数调用(Function Calling)
和推理执行(ReAct)
模式,使Agent能动态发现并调用外部工具。
二、基础配置详解
配置文件结构
在Dify插件配置中添加以下JSON,支持多服务并行:
{"服务名称1": {"transport": "sse", // 传输协议"url": "http://127.0.0.1:8000/sse", // 服务地址"headers": {}, // 自定义头"timeout": 50 // 超时设置(秒)},"服务名称2": {"transport": "streamable_http","url": "http://127.0.0.1:8001/mcp"}
}
关键参数说明:
transport
:必选项,支持sse
或streamable_http
sse_read_timeout
:SSE专属读取超时设置- 服务数量无限制,可按需求扩展
配置示意图
图:多服务配置示例
三、托管MCP服务实战
1. Composio托管服务
适用场景:快速接入预置工具集
- 服务地址:https://mcp.composio.dev
- 配置示例:
{"tavily": {"url": "https://mcp.composio.dev/tavily/your-api-key"}
}
图:服务选择界面
2. Zapier托管方案
优势:无缝集成数千款应用
- 获取MCP URL:https://actions.zapier.com/settings/mcp
- 配置示例:
{"zapier-mcp": {"url": "https://actions.zapier.com/mcp/sk-xxxxxx/sse"}
}
- 添加Action扩展工具集:
3. MCP.so 双协议支持
同时提供两种传输方案:
// SSE方案
{"tavily-mcp": {"url": "https://router.mcp.so/sse/xxxxxx"}
}// Streamable HTTP方案
{"tavily-mcp": {"transport": "streamable_http","url": "https://router.mcp.so/mcp/xxxxxx"}
}
四、插件安装指南
GitHub安装步骤
- 访问Dify插件管理页
- 选择"通过GitHub安装"
- 输入仓库地址:
https://github.com/junjiem/dify-plugin-agent-mcp_sse
- 选择版本与包文件
五、常见问题解决
Q1:安装时报签名错误
错误信息:
plugin verification has been enabled, and the plugin you want to install has a bad signature
解决方案:
在Dify的.env
文件中添加:
FORCE_VERIFYING_SIGNATURE=false
Q2:离线环境部署
推荐使用插件重打包工具:
# 下载工具
git clone https://github.com/junjiem/dify-plugin-repackaging
# 生成含依赖的离线包
python repackage.py --url https://github.com/junjiem/dify-plugin-agent-mcp_sse
结语
通过合理配置MCP服务,您的Dify Agent将获得:
🔹 动态工具发现能力
🔹 多服务并行调度
🔹 企业级API集成扩展
立即部署MCP服务,释放Dify的全部潜力!
本文依据GitHub项目dify-plugin-agent-mcp_sse文档整理
作者:Junjie.M @ GitHub
问题反馈:项目Issues
文章亮点:
- 技术细节可视化:包含4张配置示意图
- 实战导向:每个配置项附带可复用的代码块
- 问题驱动:针对常见错误提供解决方案
- 企业级方案:突出托管服务的商业化应用价值
如需获得文章配图原始文件或进一步定制内容,欢迎在评论区留言!