Dify Connect MCP：Dify 工作流无缝集成 MCP（模型上下文协议）-首席AI分享圈

🚀邀请体验：中国首家 AI IDE 智能编程软件 Trae 中文版下载，不限量使用 DeepSeek-R1 和 Doubao-pro!

综合介绍

Dify Connect MCP 是一个开源项目，托管在 GitHub 上，旨在为 Dify 平台的用户提供一个便捷的工具，通过模型上下文协议（Model Context Protocol, MCP）实现与 Dify 工作流的无缝连接。该项目由 difybase 团队开发，专注于提升 AI 应用的开发效率，特别适合需要集成复杂工作流的开发者。它通过标准化的协议支持，将外部服务与 Dify 的核心功能（如模型调用、知识库访问等）高效对接。无论是个人开发者还是企业用户，都可以通过这个工具快速实现自定义功能扩展，简化开发流程。目前，该项目仍处于开发阶段，社区活跃度较高，欢迎开发者参与贡献代码或提出建议。

功能列表

支持 MCP 协议的服务器搭建：提供一个基于模型上下文协议的服务器框架，用于连接 Dify 工作流。
Dify API 集成：通过配置 Dify 的 API 密钥和基础 URL，实现与 Dify 平台的直接通信。
多工作流支持：允许多个 Dify 工作流通过不同的密钥进行管理和调用。
标准化上下文传递：利用 MCP 协议，确保外部服务与 Dify 的数据交互顺畅。
开源协作：项目代码完全开源，用户可自由修改或扩展功能以满足特定需求。
调试支持：提供与 MCP Inspector 等工具的兼容性，便于开发者调试和优化。

使用帮助

安装流程

Dify Connect MCP 是一个基于 GitHub 的开源项目，需要一定的技术基础来安装和使用。以下是详细的安装步骤：

环境准备
- 确保你的电脑已安装 Node.js（推荐版本 16 或以上）和 Git。
- 如果需要调试，建议安装 MCP Inspector，可以通过官方文档获取安装方法。
- 准备一个 Dify 账户，并获取 API 密钥（Dify API Key）和基础 URL（通常为 https://cloud.dify.ai/v1，根据你的部署可能不同）。
克隆项目代码
打开终端，输入以下命令将项目克隆到本地：

git clone https://github.com/difybase/dify-connect-mcp.git

克隆完成后，进入项目目录：

cd dify-connect-mcp

安装依赖
项目基于 TypeScript 开发，需要安装相关依赖。运行以下命令：

npm install

这会自动下载项目所需的所有 npm 包。

配置环境变量
在项目根目录下创建一个 config.yaml 文件，用于存放 Dify 的配置信息。示例配置如下：

dify_base_url: "https://cloud.dify.ai/v1"
dify_app_sks:
- "app-sk1"
- "app-sk2"

dify_base_url：Dify 平台的 API 地址。
dify_app_sks：Dify 应用的密钥列表，每个密钥对应一个工作流。

构建并运行
完成配置后，使用以下命令构建项目：
```
npm run build
```
构建完成后，运行服务器：
```
npm start
```
如果看到类似“Server running”的日志，说明服务器已成功启动。

如何使用

安装完成后，Dify Connect MCP 作为一个 MCP 服务器运行，可以通过标准输入输出（stdio）与客户端通信。以下是具体使用方法：

配置客户端

要在客户端（如 Claude Desktop 或其他支持 MCP 的工具）中使用，需要在客户端配置文件中添加 MCP 服务器信息。示例配置如下：

{
"mcpServers": {
"dify-connect-mcp": {
"command": "node",
"args": ["<你的项目路径>/build/index.js"],
"env": {
"DIFY_API_KEY": "your-api-key"
}
}
}
}

<你的项目路径>：替换为 dify-connect-mcp 的实际路径。
DIFY_API_KEY：替换为你在 Dify 平台获取的 API 密钥。

保存配置文件后，重启客户端，MCP 服务器将自动与 Dify 平台建立连接。

调用 Dify 工作流

假设你已在 Dify 平台创建了一个工作流（比如名为“text-analyzer”的文本分析工作流），可以通过以下步骤调用：

确保 config.yaml 中已添加对应工作流的密钥。

在支持 MCP 的客户端中，输入类似以下指令：

运行 text-analyzer 工作流，输入文本为“这是测试消息”

MCP 服务器会将请求发送到 Dify，执行工作流并返回结果。

调试与优化

如果遇到问题，可以使用 MCP Inspector 进行调试：

启动 MCP Inspector（具体方法参考其文档）。
在终端运行以下命令，启用调试模式：
```
npm run start:debug
```
Inspector 会显示通信日志，帮助你定位问题。

主要功能操作流程

1. 集成 Dify API

操作步骤：编辑 config.yaml，填入 Dify 的基础 URL 和 API 密钥。
功能作用：实现与 Dify 云端或自托管实例的连接，支持调用模型、知识库等资源。
注意事项：确保密钥有效且与目标工作流匹配，否则会返回认证错误。

2. 多工作流管理

操作步骤：在 dify_app_sks 列表中添加多个密钥，每个密钥对应一个工作流。
功能作用：允许同时运行多个独立的工作流，例如文本生成、数据分析等。
使用示例：配置两个密钥分别调用“翻译工作流”和“摘要工作流”，输入相同文本可同时获取翻译和摘要结果。

3. 自定义扩展

操作步骤：
1. 修改项目源码（如 src/index.ts），添加新功能。
2. 重新构建并运行：npm run build && npm start。
功能作用：满足特定需求，比如增加日志记录或自定义数据处理逻辑。
注意事项：建议先fork 项目并在本地测试，避免直接修改主分支。