JinDaGe - dify-plugin-tools-mcp

article

README

🚀 Dify 插件安装与配置指南

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

🚀 快速开始

在开始安装和配置 MCP 插件前，请确保您已对 Dify 平台有基本了解，且具备相应的操作权限。

✨ 主要特性

多协议支持：支持 SSE 和 Streamable HTTP 等不同传输协议，满足多样化的远程服务连接需求。
灵活安装方式：既可以通过 GitHub 在线安装，也支持离线安装，方便不同网络环境下的使用。

📦 安装指南

通过 GitHub 安装插件

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

离线安装指南

下载插件包：使用脚本工具从 Dify 市场或 GitHub 下载所需的插件包。
重新打包离线包：将依赖项一并包含在内，生成一个完整的离线安装包（无需联网）。
通过脚本安装：使用提供的 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 平台的帮助文档或联系技术支持团队。

dify-plugin-tools-mcp_sse