Back to MCP directory
publicPublicdnsLocal runtime

dify-mcp-client

Dify MCP客户端插件,作为代理策略插件,允许ReAct代理节点连接MCP服务器,将工具、资源和提示列表转换为Dify工具,供LLM调用。

article

README

🚀 Dify 插件开发指南

本指南将为你详细介绍 Dify 插件的开发流程,包括安装配置、开发步骤以及参考文档等内容,帮助你快速上手 Dify 插件开发。

🚀 快速开始

安装与配置

下载插件 SDK

  • Windows 系统:下载 dify-plugin-windows-amd64.exe(版本 0.0.7)
  • Linux 系统:选择适合你操作系统的版本 点击此处

安装步骤

  1. 将下载的文件重命名为 dify.exe
  2. 创建目录 C:\Users\user\AppData\Local\dify 并将其添加到系统路径
  3. dify.exe 复制到 dify-mcp-client/ 目录下

初始化开发环境

  1. 进入项目目录:
    cd dify-mcp-client
    
  2. 激活虚拟环境(推荐使用 Python 3.12+):
    uv venv -p 3.12
    .venv\Scripts\activate
    
  3. 安装开发依赖:
    uv pip install -r requirements.txt
    

配置环境变量

  • 复制 env.example 并重命名为 .env
  • 修改 REMOTE_INSTALL_HOSTlocalhost
  • 更新 REMOTE_INSTALL_KEY(若出现错误,请重新获取)

插件开发流程

创建插件项目

  1. 初始化插件:
    python -m main
    
  2. 停止插件运行(使用 Ctrl+C
  3. 将项目打包为 .difypkg 文件:
    dify plugin package ./ROOT_OF_YOUR_PROJECT
    

📚 详细文档

Dify 插件 SDK

MCP 协议文档

⚠️ 重要提示

插件的 requirements.txt 文件已经包含所有必要的 Python 依赖,无需额外下载 MCP SDK。

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client