返回 MCP 目录
public公开dns本地运行

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

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端