关键词

Dify工具平台MCP插件API桥接

使用说明

项目简介

本项目是一个 Dify 插件，旨在将 Dify 平台已有的工具（Tools）转换为兼容 Model Context Protocol (MCP) 协议的 API 服务。通过安装此插件，可以将 Dify 工具以标准化的 MCP 接口暴露出去，从而允许任何 MCP 客户端（例如 Cherry Studio）调用 Dify 中配置的各种工具。这使得 Dify 平台可以作为 MCP 服务器，为 LLM 应用提供工具能力。

请注意： 本插件并非独立的 MCP 服务器，而是 Dify 平台的扩展，需要安装在 Dify 平台上才能工作。它依赖于 Dify 平台自身的工具管理和执行能力。

主要功能点

  • MCP 协议兼容： 实现了 MCP 协议中关于工具列表获取 ('tools/list') 和工具调用 ('tools/call') 的 JSON-RPC 接口，以及初始化 ('initialize') 和通知 ('notifications/initialized') 等方法。
  • Dify 工具桥接： 将 Dify 平台中已配置的工具信息（包括工具名称、描述、参数等）转换为 MCP 协议要求的格式。
  • 工具动态发现： MCP 客户端可以通过 'tools/list' 方法动态获取 Dify 平台当前可用的工具列表。
  • 工具远程调用： MCP 客户端可以通过 'tools/call' 方法远程调用 Dify 平台上的工具，并接收工具执行结果。
  • SSE 协议支持： 通过 SSE (Server-Sent Events) 协议向 MCP 客户端推送数据，实现实时的响应和通知。

安装步骤

  1. 访问 Dify 平台插件管理页面。 通常在 Dify 后台管理界面的 "插件" 或 "扩展" 菜单下。
  2. 选择 "通过 GitHub 安装插件"。 在插件安装方式中选择从 GitHub 仓库安装。
  3. 输入仓库地址： 在弹出的输入框中粘贴本仓库的 GitHub 地址：'https://github.com/junjiem/dify-plugin-mcp_compat_dify_tools'。
  4. 选择版本号和包文件。 根据需要选择插件的版本，并选择对应的包文件进行安装。
  5. 等待插件安装完成。 Dify 平台会自动下载并安装插件。
  6. 配置 API 端点并添加工具列表。 安装完成后，在 Dify 插件配置中，需要添加一个 API 端点，并将需要暴露为 MCP 服务的 Dify 工具添加到该端点。具体操作参考 'README.md' 文件中的截图说明（_assets 文件夹下）。
  7. 启用 API 端点。 确保新添加的 API 端点处于启用状态。

服务器配置 (MCP 客户端配置)

MCP 客户端需要配置连接到此 MCP 服务器的信息。由于本插件是 Dify 的扩展，因此 MCP 服务器实际上运行在 Dify 平台内部。MCP 客户端需要配置的是访问 Dify 平台提供的 MCP API 端点的 URL。

以下是一个 MCP 客户端 (例如 Cherry Studio) 可能需要的配置信息 JSON 示例：

{
  "serverName": "Dify MCP Tools",
  "protocol": "SSE",
  "url": "【Dify 平台 MCP API 端点 URL】",
  "options": {
    "headers": {
      "Content-Type": "application/json"
    }
  }
}

配置说明：

  • 'serverName': MCP 服务器的名称，可以自定义，例如 "Dify MCP Tools"。
  • 'protocol': 连接协议，本插件使用 SSE 协议，因此设置为 '"SSE"'。
  • 'url': 【关键配置】 Dify 平台提供的 MCP API 端点 URL。 这个 URL 需要从 Dify 平台的插件配置中获取。具体来说，在 Dify 平台成功配置并启用 MCP 兼容插件的 API 端点后，会生成一个 URL，例如 'http(s)://<你的Dify平台地址>/plugins/endpoints/<插件端点名称>/sse'。你需要将这个 完整的 URL 复制粘贴到此处。
  • 'options': 连接选项，通常需要设置请求头 'Content-Type: application/json'，表明客户端发送 JSON 格式的数据。

获取 Dify 平台 MCP API 端点 URL 的步骤：

  1. 登录 Dify 平台后台管理界面。
  2. 找到插件管理页面，并进入 'dify-plugin-mcp_compat_dify_tools' 插件的配置页面。
  3. 在插件配置页面中，找到您之前添加的 API 端点。
  4. 复制该 API 端点对应的 SSE URL (通常会显示为类似 "MCP SSE URL" 或 "API Endpoint URL (SSE)")。
  5. 将复制的 URL 粘贴到 MCP 客户端配置 JSON 中的 '"url"' 字段。

基本使用方法

  1. 启动 MCP 客户端。 例如 Cherry Studio 或其他兼容 MCP 协议的客户端。
  2. 在 MCP 客户端中配置上述服务器连接信息。 确保 URL 配置正确，协议选择 SSE。
  3. 连接到 MCP 服务器。 在 MCP 客户端中点击 "连接" 或类似按钮，尝试连接到 Dify MCP 服务器。
  4. 获取工具列表。 连接成功后，MCP 客户端通常会自动或手动请求工具列表。您应该能在客户端界面看到从 Dify 平台同步过来的工具列表。
  5. 调用工具。 选择需要调用的工具，根据工具的参数描述填写参数，并执行调用。
  6. 查看工具执行结果。 工具执行结果会通过 SSE 通道实时返回到 MCP 客户端，您可以在客户端界面查看结果。

注意：

  • 本插件依赖 Dify 平台及其工具功能的正常运行。请确保 Dify 平台和相关工具配置正确。
  • MCP 客户端与 Dify MCP 服务器之间的通信基于网络，请确保网络连接畅通。
  • 如果修改了 Dify 平台的工具列表或插件配置，可能需要重启 MCP 客户端或重新连接以同步最新的工具信息。

信息

分类

网页与API

访问项目