🚀 Dify 插件安装与配置指南

Dify 的 MCP 插件为用户提供了通过不同传输协议（如 SSE 和 Streamable HTTP）连接并使用远程服务的能力。本指南将详细介绍该插件的安装、配置方法，以及常见问题的解决办法。

🚀 快速开始

MCP 插件允许用户通过不同的传输协议（如 SSE 和 Streamable HTTP）连接和使用远程服务。下面将为你详细介绍如何安装、配置和使用 MCP 插件。

📦 安装指南

通过 GitHub 安装插件

1. 访问 Dify 平台：打开 Dify 平台，进入插件管理页面。
2. 选择通过 GitHub 安装：在插件管理页面中，找到“通过 GitHub 安装”选项。
3. 输入仓库地址：输入 MCP 插件的 GitHub 仓库地址：https://github.com/yourusername/mcp-plugin.git
4. 选择版本和包文件：根据需求选择合适的版本号和包含依赖的包文件，完成安装。
5. 验证安装：安装完成后，在 Dify 平台中测试插件功能是否正常。

离线安装指南

1. 下载插件包：使用脚本工具从 Dify 市场或 GitHub 下载所需的插件包。
2. 重新打包离线包：将依赖项一并包含在内，生成一个完整的离线安装包（无需联网）。
3. 通过脚本安装：使用提供的 GitHub 仓库中的脚本工具完成离线安装：

https://github.com/junjiem/dify-plugin-repackaging

💻 使用示例

MCP 插件配置示例

示例 1: 使用 SSE 协议

{
  "tavily-mcp": {
    "url": "https://router.mcp.so/sse/xxxxxxxxxxx"
  }
}

示例 2: 使用 Streamable HTTP 协议

{
  "tavily-mcp": {
    "transport": "streamable_http",
    "url": "https://router.mcp.so/mcp/xxxxxxxxxxx"
  }
}

📚 详细文档

常见问题解答 (FAQ)

1. 安装插件时遇到错误怎么办？

• 问题描述：安装插件时出现错误信息：“plugin verification has been enabled, and the plugin you want to install has a bad signature”。
• 解决方法：
  • 在 .env 文件末尾添加以下内容：

FORCE_VERIFYING_SIGNATURE=false

添加该字段后，Dify 平台将允许安装所有未在 Dify 市场验证的插件（可能存在安全隐患）。

2. 如何处理授权设置无效且无错误消息的问题？

• 问题描述：设置超时时间超过了 Nginx 的默认保持连接超时时间（65 秒）。
• 解决方法：
  • 方案 1：修改 .env 文件中的 NGINX_KEEPALIVE_TIMEOUT 值，例如：

NGINX_KEEPALIVE_TIMEOUT=650

• 方案 2：在 MCP 服务配置中调整超时设置，例如：

{
  "timeout": 50,
  "sse_read_timeout": 50
}

⚠️ 注意事项

⚠️ 重要提示

安装插件前，请确保已备份重要数据，以防配置错误导致服务中断。

💡 使用建议

修改 .env 文件或 MCP 服务配置时，建议先测试环境是否正常运行。

通过以上步骤，您可以顺利完成 MCP 插件的安装、配置和使用。如有其他问题，请随时查阅 Dify 平台的帮助文档或联系技术支持团队。