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客戶端。