mcp-сервер-apache-airflow
Реализация сервера Model Context Protocol (MCP) для Apache Airflow, обеспечивающая бесшовную интеграцию с клиентами MCP. Этот проект предоставляет стандартизированный способ взаимодействия с Apache Airflow через Model Context Protocol.
О
Этот проект реализует сервер Model Context Protocol , который оборачивает REST API Apache Airflow, позволяя клиентам MCP взаимодействовать с Airflow стандартизированным образом. Он использует официальную клиентскую библиотеку Apache Airflow для обеспечения совместимости и удобства обслуживания.
Related MCP server: MCP Server for Apache Airflow
Статус реализации функции
Особенность | API-путь | Статус |
Управление DAG | ||
Список DAG |
| ✅ |
Получить сведения о DAG |
| ✅ |
Пауза DAG |
| ✅ |
Возобновить DAG |
| ✅ |
Обновление DAG |
| ✅ |
Удалить DAG |
| ✅ |
Получить исходный код DAG |
| ✅ |
Патч нескольких DAG |
| ✅ |
Повторная обработка файла DAG |
| ✅ |
DAG работает | ||
Список запусков DAG |
| ✅ |
Создать DAG-запуск |
| ✅ |
Получить сведения о запуске DAG |
| ✅ |
Обновление DAG Run |
| ✅ |
Удалить DAG Run |
| ✅ |
Получить пакет DAG Runs |
| ✅ |
Очистить DAG Run |
| ✅ |
Установить DAG Run Note |
| ✅ |
Получить события набора данных Upstream |
| ✅ |
Задачи | ||
Список задач DAG |
| ✅ |
Получить детали задачи |
| ✅ |
Получить экземпляр задачи |
| ✅ |
Список экземпляров задач |
| ✅ |
Экземпляр задачи обновления |
| ✅ |
Очистить экземпляры задач |
| ✅ |
Установить состояние экземпляров задач |
| ✅ |
Переменные | ||
Список переменных |
| ✅ |
Создать переменную |
| ✅ |
Получить переменную |
| ✅ |
Обновить переменную |
| ✅ |
Удалить переменную |
| ✅ |
Связи | ||
Список подключений |
| ✅ |
Создать соединение |
| ✅ |
Получить соединение |
| ✅ |
Обновить соединение |
| ✅ |
Удалить соединение |
| ✅ |
Тестовое соединение |
| ✅ |
Бассейны | ||
Список пулов |
| ✅ |
Создать пул |
| ✅ |
Получить бассейн |
| ✅ |
Обновление пула |
| ✅ |
Удалить пул |
| ✅ |
XComs | ||
Список XComs |
| ✅ |
Получить XCom Entry |
| ✅ |
Наборы данных | ||
Список наборов данных |
| ✅ |
Получить набор данных |
| ✅ |
Получить события набора данных |
| ✅ |
Создать событие набора данных |
| ✅ |
Получить событие очереди набора данных DAG |
| ✅ |
Получить события очереди набора данных DAG |
| ✅ |
Удаление события DAG Dataset Queued |
| ✅ |
Удалить события очереди набора данных DAG |
| ✅ |
Получить набор данных событий, поставленных в очередь |
| ✅ |
Удалить набор данных, поставленный в очередь событий |
| ✅ |
Мониторинг | ||
Получите Здоровье |
| ✅ |
Статистика DAG | ||
Получить статистику DAG |
| ✅ |
Конфигурация | ||
Получить конфигурацию |
| ✅ |
Плагины | ||
Получить плагины |
| ✅ |
Поставщики | ||
Список поставщиков |
| ✅ |
Журналы событий | ||
Список журналов событий |
| ✅ |
Получить журнал событий |
| ✅ |
Система | ||
Получить ошибки импорта |
| ✅ |
Получить сведения об ошибке импорта |
| ✅ |
Получить статус здоровья |
| ✅ |
Получить версию |
| ✅ |
Настраивать
Зависимости
Этот проект зависит от официальной клиентской библиотеки Apache Airflow ( apache-airflow-client ). Она будет автоматически установлена при установке этого пакета.
Переменные среды
Установите следующие переменные среды:
AIRFLOW_HOST=<your-airflow-host>
AIRFLOW_USERNAME=<your-airflow-username>
AIRFLOW_PASSWORD=<your-airflow-password>
AIRFLOW_API_VERSION=v1 # Optional, defaults to v1Использование с Claude Desktop
Добавьте в ваш claude_desktop_config.json :
{
"mcpServers": {
"mcp-server-apache-airflow": {
"command": "uvx",
"args": ["mcp-server-apache-airflow"],
"env": {
"AIRFLOW_HOST": "https://your-airflow-host",
"AIRFLOW_USERNAME": "your-username",
"AIRFLOW_PASSWORD": "your-password"
}
}
}
}Альтернативная конфигурация с использованием uv :
{
"mcpServers": {
"mcp-server-apache-airflow": {
"command": "uv",
"args": [
"--directory",
"/path/to/mcp-server-apache-airflow",
"run",
"mcp-server-apache-airflow"
],
"env": {
"AIRFLOW_HOST": "https://your-airflow-host",
"AIRFLOW_USERNAME": "your-username",
"AIRFLOW_PASSWORD": "your-password"
}
}
}
}Замените /path/to/mcp-server-apache-airflow на фактический путь, по которому вы клонировали репозиторий.
Выбор групп API
Вы можете выбрать группы API, которые хотите использовать, установив флаг --apis .
uv run mcp-server-apache-airflow --apis "dag,dagrun"По умолчанию используются все API.
Допустимые значения:
конфигурация
соединения
даг
дагрун
dagstats
набор данных
журнал событий
importerror
мониторинг
плагин
бассейн
поставщик
taskinstance
переменная
xcom
Ручное исполнение
Вы также можете запустить сервер вручную:
make runmake run принимает следующие параметры:
Параметры:
--port: Порт для прослушивания SSE (по умолчанию: 8000)--transport: Тип транспорта (stdio/sse, по умолчанию: stdio)
Или вы можете запустить сервер sse напрямую, который принимает те же параметры:
make run-sseУстановка через Smithery
Чтобы автоматически установить Apache Airflow MCP Server для Claude Desktop через Smithery :
npx -y @smithery/cli install @yangkyeongmo/mcp-server-apache-airflow --client claudeВнося вклад
Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.