Pipedream

MCP-сервер Pipedream

Это эталонная реализация сервера Pipedream MCP. Вы можете запустить свой собственный сервер MCP для более чем 2500 приложений и API , работающий на Pipedream Connect .

Ты можешь:

• Запустите серверы локально с помощью npx @pipedream/mcp
• Размещайте серверы самостоятельно , чтобы использовать их в своем приложении или компании.

Посмотрите на сервер в действии на mcp.pipedream.com и chat.pipedream.com

Мы опубликовали этот код в качестве справочного материала, чтобы вы могли лучше понять, как использовать Pipedream Connect для такого приложения. Это все еще находится в стадии разработки и не полностью документировано. Пожалуйста, свяжитесь с нами, если у вас есть какие-либо вопросы.

⭐ Особенности

• Запустите собственный сервер MCP для более чем 2500 приложений и API
• Управляйте серверами для своих пользователей в собственном приложении.
• Подключайте учетные записи, настраивайте параметры и делайте запросы API — все это с помощью инструментов
• Полностью управляемый OAuth и хранилище учетных данных ( см. документацию по безопасности )

🚀 Начало работы

MCP-серверы Pipedream используют API Pipedream Connect для управления аутентификацией и выполнения запросов API. Для запуска MCP-сервера вам понадобятся проект Pipedream и учетные данные API Pipedream.

1. Подпишитесь на Pipedream
2. Создать проект . Здесь будут храниться все учетные записи, подключенные через MCP.
3. Создайте клиент Pipedream OAuth
4. Установите переменные окружения (см. .env.example ) (непосредственно в сеансе оболочки, dot-файлах и т. д.):

Непостижимые концепции для понимания

Если вы используете серверы MCP для своего приложения, вы, вероятно, захотите использовать интерфейс SSE . Сервер SSE принимает два параметра маршрута:

1. external_user_id — Это идентификатор вашего пользователя в вашей системе — то, что вы используете для его уникальной идентификации. Любые запросы, сделанные по этому маршруту, связаны с этим конечным пользователем и будут использовать хранилища Pipedream для аутентификации этого пользователя. Подробнее см. в документации .
2. app — «Имя слага» приложения (уникальный идентификатор приложения), который находится в разделе «Аутентификация» любого приложения Pipedream . Например, слаг приложения для Slack — slack .

Если ваш пользователь 123 хочет подключиться к серверу MCP slack , ваш клиент MCP сделает запрос к маршруту /123/slack . Подробнее см. в документации SSE ниже .

Обзор сервера

Есть два способа использования этого MCP-сервера.

1 - App Specific /{external_user_id}/{app} В настоящее время доступно на mcp.pipedream.com . Вы можете использовать конечную точку для каждого приложения. Все инструменты, доступные для этого приложения, будут доступны в этой конечной точке.

2 - Динамический /{external_user_id} Это экспериментальная версия, поскольку она полагается на инструменты, способные обновляться динамически. Мы используем этот сервер для питания инструментов на chat.pipedream.com .

[!ПРИМЕЧАНИЕ] Код для динамического сервера MCP доступен в этом репозитории, но вы пока не сможете запустить его локально, поскольку он использует внутреннюю базу данных.

Если вы хотите провести это самостоятельно, сообщите нам об этом.

Хостинг собственного сервера

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

Если у вас локально установлен Docker, вы можете собрать и запустить контейнер:

Это открывает доступ к универсальному серверу MCP по адресу http://localhost:3010/:external_user_id/:app .

Разработка

cp .env.example .env и заполните данные вашего проекта разработки.

Запустите сервер с потоковым HTTP-транспортом

Вы можете использовать необязательную переменную окружения PD_SDK_DEBUG для вывода всех запросов и ответов, поступающих в API Connect.

Затем запустите инспектор:

Используйте http://localhost:3010/v1/{external_user_id}/{app} для потоковой передачи HTTP или http://localhost:3010/{external_user_id}/{app} для передачи SSE.

Эти URL-адреса также могут использоваться другими клиентами (например, Cursor).

Настройка Stdio Transport

Stdio тестировался только с MCP Inspector.

URL-адрес инспектора смотрите в журналах.

Убедитесь, что левая сторона инспектора соответствует этому:

Затем нажмите «Список инструментов», чтобы получить список инструментов MCP.

Лицензия

Доступная лицензия Pipedream Source Version 1.0 — см. https://github.com/PipedreamHQ/pipedream/blob/master/LICENSE