Dify Connect MCP: бесшовная интеграция MCP (Model Context Protocol) для рабочих процессов Dify

Общее введение

Dify Подключайтесь MCP это проект с открытым исходным кодом, размещенный на GitHub, цель которого - предоставить пользователям платформы Dify удобный инструмент для беспрепятственного подключения к рабочим процессам Dify через протокол Model Context Protocol (MCP). Разработанный командой difybase, проект нацелен на повышение эффективности разработки приложений искусственного интеллекта и особенно подходит для разработчиков, которым необходимо интегрировать сложные рабочие процессы. Он обеспечивает эффективное взаимодействие внешних сервисов с основными функциями Dify (например, вызов модели, доступ к базе знаний и т. д.) с помощью стандартизированной поддержки протоколов. Как индивидуальные разработчики, так и корпоративные пользователи могут быстро реализовать пользовательские функциональные расширения и упростить процесс разработки с помощью этого инструмента. В настоящее время проект находится на стадии разработки, сообщество очень активно, разработчики могут участвовать в создании кода или вносить предложения.

Список функций

• Настройка сервера с поддержкой протокола MCP: Предоставляет серверную структуру для соединения рабочих процессов Dify на основе протокола Model Context Protocol.
• Интеграция API Dify: Обеспечивает прямую связь с платформой Dify путем настройки ключа API Dify и базового URL.
• Поддержка нескольких рабочих процессов: Позволяет управлять несколькими рабочими процессами Dify и вызывать их с помощью разных ключей.
• Стандартизированная доставка контекста: Использование протокола MCP для обеспечения бесперебойного взаимодействия данных между внешними службами и Dify.
• Сотрудничество с открытым исходным кодомКод проекта полностью открыт, пользователи могут свободно изменять или расширять функции для удовлетворения конкретных потребностей.
• Поддержка отладки: Обеспечивает совместимость с такими инструментами, как MCP Inspector, для отладки и оптимизации.

Использование помощи

Процесс установки

Dify Connect MCP - это проект с открытым исходным кодом, основанный на GitHub, для установки и использования которого требуется определенная техническая база. Ниже приведены подробные шаги по установке:

1. Подготовка к защите окружающей среды
   • Убедитесь, что на вашем компьютере установлены Node.js (рекомендуется версия 16 или выше) и Git.
   • Если вам нужна отладка, рекомендуется установить MCP Inspector, о методе установки можно узнать из официальной документации.
   • Подготовьте учетную запись Dify и получите ключ API (Dify API Key) и базовый URL (обычно это https://cloud.dify.ai/v1(который может отличаться в зависимости от вашего развертывания).
2. Клонирование кода проекта
   Откройте терминал и введите следующую команду, чтобы клонировать проект локально:

git clone https://github.com/difybase/dify-connect-mcp.git

После завершения клонирования перейдите в каталог проекта:

cd dify-connect-mcp

3. Установка зависимостей
   Проект основан на разработке TypeScript, поэтому вам необходимо установить соответствующие зависимости. Выполните следующую команду:

npm install

Это автоматически загрузит все пакеты npm, необходимые для проекта.

4. Настройка переменных среды
   В корневом каталоге проекта создайте config.yaml файл, используемый для хранения информации о конфигурации Dify. Пример конфигурации показан ниже:

dify_base_url: "https://cloud.dify.ai/v1"
dify_app_sks:
- "app-sk1"
- "app-sk2"

• dify_base_url: адрес API для платформы Dify.
• dify_app_sks: Список ключей для приложения Dify, каждый из которых соответствует рабочему процессу.

5. Постройте и запустите
   После завершения настройки используйте следующую команду для сборки проекта:

   npm run build
   

   После завершения сборки запустите сервер:

   npm start
   

   Если вы видите журнал типа "Сервер запущен", значит, сервер успешно запущен.

Как использовать

После установки Dify Connect MCP работает как MCP-сервер и может взаимодействовать с клиентами через стандартный ввод и вывод (stdio). Ниже описано, как его использовать:

Настройка клиента

Чтобы создать приложение на стороне клиента (например, на Клод Desktop или других инструментов с поддержкой MCP, необходимо добавить информацию о сервере MCP в файл конфигурации клиента. Пример конфигурации показан ниже:

{
"mcpServers": {
"dify-connect-mcp": {
"command": "node",
"args": ["<你的项目路径>/build/index.js"],
"env": {
"DIFY_API_KEY": "your-api-key"
}
}
}
}

• <你的项目路径>: Заменить на dify-connect-mcp Фактический путь к
• DIFY_API_KEY: Замените на ключ API, полученный от платформы Dify.

После сохранения файла конфигурации и перезапуска клиента сервер MCP автоматически установит соединение с платформой Dify.

Вызов рабочих процессов Dify

Если вы создали рабочий процесс в платформе Dify (например, рабочий процесс анализа текста под названием "text-analyzer"), вы можете вызвать его, выполнив следующие действия:

1. безопасный config.yaml Ключ для соответствующего рабочего процесса был добавлен в
2. На клиенте с поддержкой MCP введите команду, аналогичную следующей:

   运行 text-analyzer 工作流，输入文本为“这是测试消息”
   

3. Сервер MCP отправляет запрос в Dify, выполняет рабочий процесс и возвращает результаты.

Отладка и оптимизация

Если у вас возникли проблемы, вы можете использовать MCP Inspector для отладки:

• Запустите программу MCP Inspector (подробности см. в документации к ней).
• Выполните следующую команду в терминале, чтобы включить режим отладки:

  npm run start:debug
  

• Инспектор отображает журналы связи, чтобы помочь вам найти проблемы.

Основные функции

1. Интеграция API Dify

• процедура:: Редакция config.yamlЕсли вы хотите использовать Dify, введите базовый URL и API-ключ Dify.
• функциональная роль: Обеспечивает подключение к облачным или самостоятельным экземплярам Dify, поддерживая вызовы моделей, баз знаний и других ресурсов.
• предостережение: Убедитесь, что ключ действителен и соответствует целевому рабочему процессу, иначе будет возвращена ошибка аутентификации.

2. Управление несколькими рабочими процессами

• процедура: в dify_app_sks В список добавляется несколько ключей, каждый из которых соответствует рабочему процессу.
• функциональная роль: Позволяет одновременно выполнять несколько независимых рабочих процессов, таких как генерация текста, анализ данных и т. д.
• Пример использования: Настройте две клавиши для вызова "Рабочего процесса перевода" и "Рабочего процесса сводки" соответственно и введите один и тот же текст, чтобы получить результаты перевода и сводки одновременно.

3. Пользовательские расширения

• процедура::
  1. Измените исходный код проекта (например. src/index.ts), добавляя новые возможности.
  2. Восстановите и запустите:npm run build && npm start.
• функциональная роль: Для удовлетворения особых потребностей, например, для добавления протоколирования или пользовательской логики обработки данных.
• предостережениеРекомендуется сначала форкнуть проект и протестировать его локально, чтобы не вносить изменения непосредственно в мастер-ветку.

предостережение

• безопасность: Не раскрывайте ключ API другим лицам, рекомендуется, чтобы config.yaml стать членом .gitignore.
• совместимость: Убедитесь, что клиент поддерживает протокол MCP, иначе он не сможет установить связь.
• Поддержка общества: Если у вас возникнут проблемы, отправьте отзыв на страницу проблем на GitHub, и разработчики сообщества помогут вам.

Выполнив описанные выше шаги, вы сможете быстро начать работу с Dify Connect MCP, интегрировать рабочие процессы Dify в свои проекты и наслаждаться эффективным опытом разработки ИИ!