Difyapp As MCP Server

🚀 DifyワークフローをMCPサーバーとして公開

DifyワークフローをModel Context Protocol (MCP) プロトコルを通じてサーバーとして公開し、ClaudeなどのAIクライアントが利用できるようにします。

本プロジェクトは、DifyワークフローをModel Context Protocol (MCP) プロトコルを介して、このプロトコルをサポートするAIクライアント（Claude Desktop、Cursorなど）に公開するDifyプラグインを実装しています。このプラグインを通じて、以下のことが可能です。

• 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アプリケーションに少なくとも1つのワークフローが含まれ、正しく設定されていることを確認してください。

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. 実装の概要

• サーバーエンドポイント：MCPプロトコルをサポートするJSON - RPCインターフェースを提供
• ツールの登録：Difyワークフローを利用可能なツールとして自動的に発見して登録
• ステートレスモード：軽量でステートレスな通信方式をサポート
• セッション管理：サーバー側でセッション管理を実装し、安全な接続を確保

🛠️ トラブルシューティング

1. 一般的な問題

• MCPサーバーに接続できない場合
  • ネットワーク接続を確認する
  • サーバーアドレスが正しいことを確認する
  • サーバーが有効になっていることを確認する
• ツールが発見されない場合
  • プラグインが有効になっていることを確認する
  • アプリケーションIDが正しく設定されていることを確認する
  • Difyサービスを再起動する

🤝 コントリビューション

MCP Serverプラグインの改善に向けて、コードやドキュメントのコントリビューションを歓迎します。

📄 ライセンス

本プロジェクトは[ライセンス名]に従います。詳細については、プロジェクトリポジトリ内のLICENSEファイルを参照してください。

🙏 謝辞

本プロジェクトが実現できたのは、コミュニティのサポートと貢献者の努力のおかげです。ここに感謝の意を表します。