Dify MCP Server

Dify MCP Server

英語 | 中文

MCP クライアントと Dify アプリケーションを接続する、TypeScript ベースの MCP（Model Context Protocol）サーバーです。このサーバーは、Dify アプリケーションを MCP クライアント内で直接利用できるツールとして動的に公開します。

概要

このサーバーは Model Context Protocol を実装し、MCP クライアントと Dify アプリケーションをつなぎます。Dify API からアプリケーションの仕様を動的に取得し、MCP ツールとして公開します。MCP クライアント内の統一されたインターフェースを通じて、複数の Dify アプリケーションを利用できます。

機能

Dify との動的な連携

• API キーを使用して複数の Dify アプリケーションに接続します
• アプリケーションのメタデータとパラメーターを自動的に取得します
• Dify アプリケーションの仕様に基づいてツールインターフェースを動的に生成します
• テキスト、段落、セレクトドロップダウンなど、さまざまな入力形式に対応しています

リクエストの処理

• リクエストの再試行を備えた堅牢なエラー処理
• ブロッキングモードとストリーミングモードの両方に対応
• 大きな数値を扱うための JSON BigInt 処理

設定

• 環境変数を使用して API キーを設定します
• ベース URL とタイムアウトを設定できます
• 環境変数が利用できない場合は、デフォルト値を使用します

インストール

前提条件

• Node.js（v16 以上）
• npm または yarn

セットアップ

1. リポジトリをクローンします

git clone https://github.com/zhuzhoulin/dify-mcp-server.git
cd dify-mcp-server

2. 依存関係をインストールします

npm install

3. プロジェクトをビルドします

npm run build

Windsurf IDE との連携

Windsurf IDE で使用するには、MCP 設定にサーバーの設定を追加します。

{
  "mcpServers": {
    "dify-mcp-server": {
      "command": "node",
      "args": [
        "/path/to/dify-mcp-server/build/index.js"
      ],
      "env": {
        "AGENT_API_KEYS": "key1,key2,key3",
        "BASE_URL": "https://api.dify.ai",
        "TIMEOUT": "60000"
      }
    }
  }
}

環境変数

• AGENT_API_KEYS：Dify API キーをカンマ区切りで指定したリスト
• BASE_URL：Dify API のベース URL（デフォルト：https://api.dify.ai）
• TIMEOUT：リクエストのタイムアウト（ミリ秒単位。デフォルト：60000）

環境変数の取得方法

API キー（AGENT_API_KEYS）：複数のキーを,で区切ります

使用方法

設定すると、Dify MCP Server は次の処理を行います。

1. 指定された API キーを使用して、指定された Dify アプリケーションに接続します
2. アプリケーションのメタデータとパラメーターの仕様を取得します
3. Dify アプリケーションの設定に基づいて MCP ツールのインターフェースを生成します
4. これらのツールを Windsurf IDE 内で利用できるようにします

各 Dify アプリケーションは、dify_app_info_{application_name} という名前形式の個別のツールとして公開されます。

開発

利用可能なスクリプト

• npm run build：プロジェクトをビルドします
• npm run prepare：配布用にプロジェクトを準備します
• npm run watch：変更を監視し、再ビルドします
• npm run inspector：デバッグ用に MCP inspector を実行します

プロジェクト構成

• src/index.ts：サーバーのメイン実装
• src/request.ts：Dify API 通信用の HTTP クライアント
• src/type.ts：Dify API 用の TypeScript インターフェース

トラブルシューティング

問題が発生した場合は、次の点を確認してください。

1. API キーが正しく、必要な権限があることを確認します
2. 環境から BASE_URL にアクセスできることを確認します
3. 詳細なエラーメッセージを確認するため、サーバーログを確認します
4. Dify アプリケーションが適切に設定され、アクセス可能であることを確認します

ライセンス

このプロジェクトは、LICENSE ファイルに記載された条件に基づいてライセンスされています。