Difyapp As MCP Server

🚀 將Dify工作流作為MCP服務器暴露

本項目可將Dify工作流通過Model Context Protocol (MCP)協議暴露為服務器，供Claude等AI客戶端使用，實現了Dify工作流與支持MCP協議的AI客戶端的無縫對接。

🚀 快速開始

本項目實現了一個Dify插件，允許將Dify工作流通過Model Context Protocol (MCP)協議暴露給支持該協議的AI客戶端（如Claude Desktop、Cursor等）。通過這個插件，您可以：

• 將Dify工作流作為工具提供給Claude等AI。
• 讓AI客戶端能夠發現並使用您的工作流。
• 無需修改工作流即可集成到AI助手中。

✨ 主要特性

• ✅ 支持MCP標準的JSON - RPC接口。
• ✅ 工具自動發現和註冊。
• ✅ 與Claude Desktop/Cursor等客戶端兼容。
• ✅ 安全的SSE連接實現。
• ✅ 服務器端會話管理。
• 🔄 符合最新的MCP Streamable HTTP規範（基於PR #206）。

📚 詳細文檔

背景

Model Context Protocol (MCP) 是一個開放標準，允許AI模型與外部工具和數據源交互。隨著MCP的發展，協議正在從HTTP+SSE模式過渡到新的"Streamable HTTP"傳輸模式，為無狀態服務器提供更好的支持。

本項目跟蹤並實現了最新的MCP協議變化，特別是：

• 服務器負責生成和管理會話ID。
• 支持無狀態服務器模式（適合Dify插件環境）。
• 標準化的消息格式和流處理。
• 安全的會話管理和身份驗證。

配置插件設置

1. 插件配置

在Dify中安裝並啟用MCP Server插件後，您需要進行以下配置：

• 應用ID：您想要暴露的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中使用插件。

技術細節

1. 實現概述

• 服務器端點：提供JSON - RPC接口，支持MCP協議。
• 工具註冊：自動發現和註冊Dify工作流為可用電工具。
• 無狀態模式：支持輕量級、無狀態的通信方式。
• 會話管理：服務器端實現會話管理，確保安全連接。

故障排除

1. 常見問題

• 無法連接到MCP服務器：

  • 檢查網絡連接。
  • 確保服務器地址正確。
  • 確保服務器已啟用。

• 工具未被發現：

  • 檢查插件是否已啟用。
  • 確保應用ID配置正確。
  • 重啟Dify服務。

🤝 貢獻

歡迎貢獻代碼和文檔，幫助改進MCP Server插件。

📄 許可證

本項目遵循[許可證名稱]協議。請參考項目倉庫中的LICENSE文件獲取詳細信息。

🙏 致謝

感謝社區的支持和貢獻者們的努力，使本項目得以實現。