SAP HANA CLI — MCP для работы с базой SAP HANA
SAP HANA CLI
Инструмент разработчика SAP HANA с MCP-сервером: агент работает с базой и контейнерами HDI через основные инструменты
- 115 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Агент выполняет любые из 186 команд над базой HANA, включая изменения данных и схем, с правами подключенного пользователя
- Строка подключения к базе хранится в окружении проекта
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/sap-hana-cliОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент выполняет любые из 186 команд над базой HANA, включая изменения данных и схем, с правами подключенного пользователя
- Строка подключения к базе хранится в окружении проекта
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
hana-cli — пример командного инструмента разработчика для SAP HANA, который SAP-samples выпускает как пакет npm. Он нужен тем, кто разрабатывает под HANA вне инструментов SAP, например в VS Code, с локальным HANA Express, удаленной базой или в облаке: BTP, HANA Cloud, Business Application Studio, Google Cloud Shell. В составе больше двадцати команд, веб-интерфейс на порту 3010 и REST API. В пакет входит MCP-сервер `hana-cli-mcp`. Он работает по принципу постепенного раскрытия: в начале агенту доступны около 22 основных инструментов, остальные подтягиваются по требованию. Маршрутизатор `hana_execute` вызывает любую из 186 команд по имени. Есть подсказки команд, готовые сценарии из нескольких шагов, примеры и доступ к 279 страницам документации. Режим `--full` открывает все инструменты сразу. Можно подключить сервер без установки: `npx -y -p hana-cli hana-cli-mcp`. Если hana-cli уже стоит, команда `hana-cli mcp` сама настраивает Claude Desktop, Claude Code и Cursor, а `hana-cli mcp-status` показывает состояние. Для VS Code есть расширение SAP HANA CLI MCP Server, для Claude Code отдельный плагин.
Для кого. Разработчикам на SAP HANA, которые пишут в VS Code или облачных оболочках и хотят вести базу, схемы и контейнеры HDI через Claude, Cursor или Copilot.
Подходит, если
- Нужно разобрать схему HANA и найти таблицы и представления без ручных запросов
- Агент должен проверить состояние контейнеров HDI и сервисов BTP из чата
- Вы разрабатываете под HANA в VS Code и хотите, чтобы команды базы вызывались словами
- Требуется один раз настроить MCP сразу для Claude Desktop, Claude Code и Cursor
- Хочется сначала посмотреть, что изменит установка, командой `hana-cli mcp --dry-run`
Не подходит, если
- Нет базы SAP HANA или доступа к ней: сервер управляет только ею и сервисами SAP
- Нужен рабочий производственный инструмент: проект учебный пример от SAP-samples и не входит в поддерживаемые продукты SAP
- Агенту нельзя доверять изменения в базе без присмотра: заранее ограничьте права пользователя базы
Пример запроса к агенту
Покажи схемы в моей базе HANA, найди таблицы с именем orders и перечисли их столбцы.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Проект опубликован как учебный пример в организации SAP-samples и не относится к поддерживаемым продуктам SAP. Версия 4.x принесла крупные изменения: переход на Express 5 и новая работа с подключением к базе. При проблемах автор советует откатиться на версию 3.202601.0 командой `npm install -g hana-cli@3.202601.0`.
Сервер может выполнять любую из 186 команд, в том числе изменяющие данные, поэтому права подключенного пользователя базы определяют, что сделает агент. Для работы нужны Node.js, доступ к HANA и параметры подключения.
Документация большая и лежит в папке `docs/`, подробности установки MCP описаны в `docs/03-features/mcp-integration.md` и `mcp-server/README.md`.
Как отключить. Выполните `hana-cli mcp-status`, чтобы увидеть, где зарегистрирован сервер, и удалите запись `hana-cli` из конфигурации клиента. Глобальный пакет удаляется командой `npm uninstall -g hana-cli`.
Частые вопросы
Как быстрее всего подключить?
Если hana-cli уже установлен, выполните `hana-cli mcp`: команда сама найдет клиентов и настроит их. Без установки используйте `npx -y -p hana-cli hana-cli-mcp`.
Что показывает hana-cli mcp --dry-run?
Команда показывает, что будет записано в конфигурации клиентов, и ничего не меняет. Конкретного клиента выбирают ключом `--client`, например `--client cursor`.
Сколько инструментов в сервере?
Около 22 основных при старте и 186 всего. Маршрутизатор `hana_execute` вызывает любую команду по имени, а ключ `--full` открывает все инструменты сразу.
Есть ли расширение для VS Code и плагин для Claude Code?
Да. Расширение называется SAP HANA CLI MCP Server и ставится командой `code --install-extension SAPOSS.hana-cli-mcp`. Плагин ставится командой `/plugin install https://github.com/SAP-samples/hana-cli-claude-plugin`.
Где опубликован сервер?
Сервер записан в официальном реестре MCP как `io.github.SAP-samples/hana-cli`, пакет npm называется hana-cli, а исполняемый файл сервера hana-cli-mcp.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для SAP HANA и HANA Cloud: схема, SQL с лимитами строк и 34 инструмента, запись в базу по умолчанию заблокирована
MCP-сервер для SAP BW/4HANA и BW 7.5 on HANA: агент читает и меняет объекты моделирования, запускает запросы и разбирает загрузки.
Один MCP-сервер для SQLite, SQL Server, PostgreSQL и MySQL: агент читает и меняет данные, правит схему и выгружает CSV и JSON
MCP-сервер Byaan передает Claude Code и Cursor вопросы к вашим базам данных и возвращает запросы с результатами в режиме чтения.
MCP-сервер и CLI shs для Apache Spark History Server: агент разбирает задания, стадии и сбои Spark на естественном языке
MCP-сервер на Python для работы с MySQL: список таблиц, чтение данных, выполнение SQL и разбор схемы через контролируемый интерфейс
Коротко о README
Репозиторий подает hana-cli как пример командного инструмента для SAP HANA с документацией на VitePress, схемами сред разработки и способов установки. Раздел про MCP объясняет постепенное раскрытие инструментов, маршрутизатор и интеграцию с Claude Desktop, VS Code и Cursor.