はじめに
ダイファイ 接続 エムシーピー はGitHubでホストされているオープンソースプロジェクトで、Difyプラットフォームのユーザーにモデルコンテキストプロトコル(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インストール
これにより、プロジェクトに必要なすべての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スタート
Server running」のようなログが表示されれば、サーバーは正常に起動している。
使用方法
インストールすると、Dify Connect MCPはMCPサーバーとして動作し、標準入出力(stdio)を介してクライアントと通信することができます。以下は、その使用方法の詳細です:
クライアントの設定
クライアント側でアプリケーションを作成するには(例えば クロード DesktopなどのMCP対応ツールを使用する場合は、クライアント構成ファイルにMCPサーバ情報を追加する必要があります。以下に設定例を示します:
{
"mcpServers":{」です。
"dify-connect-mcp": {
"命令": "node
"args": ["/build/index.js"]、
「env": {
"DIFY_API_KEY": "あなたのAPIキー"
}
}
}
}
<プロジェクトのパス
に置き換える。dify-connect-mcp
の実際のパス。DIFY_API_KEY
Difyプラットフォームから取得したAPIキーに置き換えてください。
設定ファイルを保存し、クライアントを再起動すると、MCPサーバーは自動的にDifyプラットフォームとの接続を確立します。
Dify ワークフローの起動
Difyプラットフォームでワークフローを作成したと仮定すると(例えば、"text-analyzer "というテキスト分析ワークフロー)、以下の手順でワークフローを呼び出すことができます:
- セキュア
config.yaml
対応するワークフローのキーが - MCP対応クライアントで、以下のようなコマンドを入力する:
テキストアナライザーワークフローを実行し、「これはテストメッセージです」というテキストを入力する。
- MCPサーバーはDifyにリクエストを送り、ワークフローを実行し、結果を返す。
デバッグと最適化
問題が発生した場合は、MCP Inspectorを使用してデバッグできます:
- MCP Inspector を起動します (詳細はマニュアルを参照してください)。
- ターミナルで以下のコマンドを実行し、デバッグモードを有効にする:
npm run start:debug
- インスペクタには通信ログが表示され、問題の特定に役立ちます。
主な機能
1.DifyAPIの統合
- 手続き:: 編集部
config.yaml
Difyを使用する場合は、DifyのベースURLとAPIキーを記入してください。 - 機能的役割Difyクラウドまたはセルフホストインスタンスへの接続を可能にし、モデル、ナレッジベース、その他のリソースへの呼び出しをサポートします。
- ほらそうでない場合は認証エラーが返される。
2.マルチ・ワークフロー管理
- 手続きで
dify_app_sks
複数のキーがリストに追加され、それぞれがワークフローに対応する。 - 機能的役割テキスト生成、データ分析など、複数の独立したワークフローを同時に実行できます。
- 使用例翻訳ワークフロー "と "サマリーワークフロー "をそれぞれ呼び出す2つのキーを設定し、同じテキストを入力すると、翻訳結果とサマリー結果が同時に表示されます。
3.カスタムエクステンション
- 手続き::
- プロジェクトのソースコードを修正する(例
src/index.ts
)、新機能を追加した。 - リビルドして走る:
npm run build && npm start
.
- プロジェクトのソースコードを修正する(例
- 機能的役割ロギングやカスタムデータ処理ロジックの追加など、特定のニーズに対応します。
- ほらmasterブランチを直接修正するのを避けるため、最初にプロジェクトをフォークし、ローカルでテストすることを推奨する。
ほら
- 安全性APIキーを他人に公開しないことを推奨します。
config.yaml
会員になる.gitignore
. - 互換性クライアントがMCPプロトコルをサポートしていることを確認してください。
- 地域支援もし問題が発生したら、GitHubのIssuesページにフィードバックを送ってください。
以上のステップで、Dify Connect MCPをすぐに使い始めることができ、Difyワークフローを自分のプロジェクトに統合し、効率的なAI開発を楽しむことができます!