Duckle MCP
MCP-сервер платформы Duckle: агент собирает, проверяет и запускает ETL-пайплайны на DuckDB на вашей машине
- 1 533 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Запускает пайплайны, которые читают и пишут в базы, файлы и облачные хранилища по сохраненным подключениям
- Управляет сохраненными подключениями, где могут лежать доступы к рабочим системам
- При первом запуске скачивает и выполняет движок DuckDB и расширения
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/duckleОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Запускает пайплайны, которые читают и пишут в базы, файлы и облачные хранилища по сохраненным подключениям
- Управляет сохраненными подключениями, где могут лежать доступы к рабочим системам
- При первом запуске скачивает и выполняет движок DuckDB и расширения
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Duckle — открытая платформа для ETL, построенная на DuckDB. Пайплайн собирают на холсте, на Python или в SQL и хранят одним файлом в git. Тот же файл запускается без интерфейса на вашем сервере по расписанию или в Docker. Встроенный сервер MCP открывает эту платформу агенту. Агент видит каталог компонентов со схемами свойств, генерирует пайплайн в выбранную папку, проверяет и запускает его без интерфейса. Он читает существующие пайплайны и журналы запусков и управляет сохраненными подключениями. После запуска агент получает происхождение данных на уровне колонок. В настольной студии кнопка Connect to Claude регистрирует сервер за вас.
Для кого. Для дата-инженеров и аналитиков, которые хотят поручить Claude Code, Cursor или Codex сборку и проверку ETL-пайплайнов на собственной инфраструктуре.
Подходит, если
- Нужно попросить агента собрать пайплайн из CSV и Parquet на DuckDB и сразу получить файл, который открывается на холсте
- Перед запуском на реальных данных надо проверить, что пайплайн компилируется, не обращаясь к источникам
- Требуется прогнать тесты пайплайна с фиксированными входными строками прямо из диалога с агентом
- Нужно выяснить, откуда в итоговой таблице взялась колонка: после запуска агент вернет происхождение данных по колонкам
Не подходит, если
- Нужен только SQL-запрос к DuckDB или MotherDuck: для этого подойдет более простой SQL-сервер MCP
- Нужна управляемая облачная платформа: Duckle запускается на вашем сервере и не предлагает облако поставщика
- На машине нельзя запускать пакеты через uvx и скачивать движок DuckDB при первом запуске
- Подключения к рабочим базам нельзя доверять агенту: он управляет сохраненными подключениями и запускает пайплайны с записью в приемники
Пример запроса к агенту
Используй duckle: покажи доступные компоненты, собери пайплайн из orders.csv с фильтром по сумме от 20 в Parquet и проверь его до запускаMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
DUCKLE_DUCKDB_BIN- Путь к исполняемому файлу duckdb, если он не лежит в PATH.
Ограничения
- Проект в бета-статусе, версии выходят часто.
- Для запуска пайплайнов нужен DuckDB CLI. Через uvx он подтягивается автоматически, а при ручной установке его ставят командой `pip install duckdb-cli`. Команда `duckle validate` движка не требует.
- Настольное приложение занимает от 73 до 110 МБ в зависимости от системы, DuckDB скачивается при первом запуске. Необязательный локальный помощник Duckie добавляет около 1,1 ГБ.
- Работает на Windows, macOS и Linux, колеса Python доступны для x86-64 и arm64.
- Проект не связан с DuckDB Labs и MotherDuck и не одобрен ими.
Как отключить. Выполните `claude mcp remove duckle` или удалите запись duckle из mcpServers в настройках клиента. Установленный пакет убирается командой `pip uninstall duckle`, настольное приложение удаляется как обычно. Скачанные движки лежат в каталоге данных приложения, например ~/Library/Application Support/io.duckle.app/engines/ на macOS, и их можно удалить вручную.
Частые вопросы
Как подключить Duckle к Claude Code через MCP?
Выполните `claude mcp add duckle -- uvx duckle mcp`. Нужен только uv, остальное он скачает сам во временное окружение. После перезапуска спросите у агента, какие компоненты доступны в Duckle.
Как агент проверяет пайплайн Duckle до запуска?
Инструмент validate_pipeline компилирует пайплайн и не обращается к источникам. Инструмент run_tests прогоняет тесты пайплайна на фиксированных входных строках, и доступ к оболочке для этого не нужен.
Чем Duckle отличается от dbt?
Duckle собирает и запускает пайплайны целиком, от подключения источников до записи в приемники, на DuckDB с холстом, Python-интерфейсом и сервером с расписанием. dbt описывает преобразования внутри хранилища, и для него в каталоге есть отдельный MCP-сервер.
Что делает `uvx duckle quickstart`?
Создает примерные данные и пайплайн, компилирует его в SQL, запускает на DuckDB и показывает строки результата.
Можно ли запускать пайплайны Duckle в CI?
Да. Пакет `pip install duckle` ставит командный раннер: `duckle validate` проверяет компиляцию каждого пайплайна без источников и сети, а коды выхода стабильны: 0 без замечаний, 1 при ошибке пайплайна, 2 если раннер не запустился.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыDuckDB / MotherDuck MCP Server
DuckDB / MotherDuck Local MCP Server
MCP-сервер для SQL-аналитики на DuckDB: локальные файлы, база в памяти, базы на S3 и MotherDuck
Десктопное рабочее место для SQL с встроенным MCP-сервером: агент читает схему и выполняет запросы в том же клиенте, где работаете вы
Легкое рабочее место для баз данных с MCP-сервером: агент читает схему, выполняет запросы и разбирает данные в PostgreSQL, MySQL и других
Официальный MCP-сервер Tableau: агент ищет источники данных, отправляет к ним запросы и открывает дашборды и метрики Pulse
Экономный по токенам MCP-сервер для PostgreSQL, MySQL, MariaDB, SQL Server и SQLite с режимом только для чтения
MCP-сервер подключает Claude Code и Codex к открытой сессии R или Python в RStudio и Positron, где лежат ваши данные
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Duckle (эта запись) | да | не нужна | 1 533 | |
| DuckDB / MotherDuck MCP Server | да | не нужна | 536 | MCP-сервер для SQL-запросов к DuckDB и MotherDuck, без построения и запуска пайплайнов |
| dbt MCP | да | API-ключ | 614 | официальный MCP dbt Labs: метаданные проекта и запуск команд dbt в хранилище |
| Dagu | да | API-ключ | 4 488 | оркестратор воркфлоу общего назначения с MCP, в нем нет компонентов и холста для данных |
Коротко о README
Главная мысль проекта — пайплайны, которыми вы владеете сами. Кроме быстрого старта через uvx, в документации есть отдельный командный раннер, журнал изменений по версиям и три способа подключить MCP-сервер к Claude, Cursor и другим клиентам.