Yevanchen Difyapp As MCP Server

🚀 将Dify工作流作为MCP服务器暴露

本项目可将Dify工作流通过Model Context Protocol (MCP)协议，作为服务器端口暴露给支持该协议的AI客户端（如Claude Desktop、Cursor等），实现Dify工作流与AI客户端的高效交互。

🚀 快速开始

本项目实现了一个Dify插件，允许您将Dify工作流通过Model Context Protocol (MCP)协议暴露给支持该协议的AI客户端。通过此插件，您可以：

• 将Dify工作流作为工具提供给Claude等AI。
• 让AI客户端能够发现并使用您的工作流。
• 无需修改现有工作流即可集成到AI助手中。

✨ 主要特性

• ✅ 支持MCP标准的JSON - RPC接口。
• ✅ 工具自动发现和注册。
• ✅ 与Claude Desktop/Cursor等客户端兼容。
• ✅ 安全的SSE连接实现。
• ✅ 服务器端会话管理。
• 🔄 符合最新的MCP流式HTTP规范（基于PR #206）。

📚 详细文档

背景

Model Context Protocol (MCP) 是一个开放标准，允许AI模型与外部工具和数据源交互。随着MCP的发展，协议正在从HTTP + SSE模式向新的"流式HTTP"传输模式过渡，为无状态服务器提供更好的支持。

本项目跟踪并实现了最新的MCP协议变化，特别是：

• 服务器负责生成和管理会话ID。
• 支持无状态服务器模式（适合Dify插件环境）。
• 标准化的消息格式和流处理。
• 安全的会话管理和身份验证。

配置插件设置

应用ID:

输入您希望暴露到MCP服务器的Dify应用ID。

其他设置:

根据需要进行其他配置。

使用方法

1. 在Dify中配置

确保您的Dify应用包含至少一个工作流，并且已经正确配置。

2. 在客户端使用

1. 打开客户端。
2. 进入设置 > MCP服务器。
3. 添加新的MCP服务器，URL填写：

   https://您的Dify实例地址/difyapp_as_mcp_server
   

4. 保存并启用该服务器。

3. 在Cursor中使用

1. 打开Cursor。
2. 进入设置 > AI > MCP。
3. 添加服务器地址：

   https://您的Dify实例地址/difyapp_as_mcp_server
   

4. 保存并启用。
5. 在Cursor Agent中使用您的工具。

故障排除

1. 连接问题:

   • 确保URL正确且可以访问。
   • 检查是否在防火墙或代理服务器后方。

2. 工具不可见:

   • 确保应用ID配置正确。
   • 确认Dify工作流已正确配置。

3. 其他问题:

   • 查看插件日志获取更多信息。
   • 联系支持团队寻求帮助。

🔧 技术细节

架构

本插件通过两个端点实现MCP服务器：

• GET 端点：处理SSE连接和HTML页面。
• POST 端点：处理JSON - RPC请求。

由于Dify插件环境的限制，我们采用了"最小可行"的SSE实现，包括：

• 服务器端会话ID生成。
• 有限心跳模式（约5分钟）。
• 客户端断开后自动重连。
• 符合最新的流式HTTP规范。

工具注册

工具会自动从Dify工作流中生成，并通过MCP协议暴露给客户端。工具定义包括：

• 名称和描述。
• 输入参数定义。
• 返回值类型。
• 参数验证。

无状态模式支持

本插件支持符合最新MCP规范的无状态服务器模式，这意味着：

• 服务器不需要维护长期连接。
• 每个请求都是独立的。
• 通过会话ID关联请求。
• 适合Dify的无状态API环境。

📄 许可证

文档未提及相关信息，故跳过该章节。

📋 项目信息

• 版本：1.0.0
• 作者：[您的姓名]
• 联系方式：[您的联系方式]

通过以上步骤，您可以成功将Dify工作流作为MCP服务器暴露给支持该协议的AI客户端。