CAP MCP Server — помощник для SAP CAP-проектов
CAP MCP Server
MCP-сервер от SAP ищет по модели CDS и локальным эмбеддингам документации CAP, чтобы агент точнее писал код приложений
- 118 ★ репозитория
- Последний коммит
- Apache-2.0
Минимальный доступ
Почему такой уровень
- Инструменты ищут по модели проекта и документации и ничего не записывают
- Поиск по эмбеддингам идет локально, исходный код проекта наружу не отправляется
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/cap-mcp-serverОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Инструменты ищут по модели проекта и документации и ничего не записывают
- Поиск по эмбеддингам идет локально, исходный код проекта наружу не отправляется
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
@cap-js/mcp-server — MCP-сервер для SAP Cloud Application Programming Model (CAP), подготовленный командой cap-js. Он помогает агенту отвечать на вопросы по проекту: какие сервисы CDS в нем есть и где они раздаются, о чем сущности и как связаны, как добавить столбцы в select в CAP Node.js. Инструментов два. `search_model` выполняет нечеткий поиск по именам определений скомпилированной модели CDS: компилятор собирает все файлы `.cds` в единое представление с определениями, связями, аннотациями и HTTP-эндпоинтами, а поиск находит сущность Books даже по запросу «book». `search_docs` ищет по предобработанной документации CAP через векторные эмбеддинги: запрос превращается в вектор, и находятся фрагменты с самым близким смыслом. Это работает локально, без внешнего сервиса. Сервер запускается командой `npx -y @cap-js/mcp-server`, подходит Claude Code, Codex, opencode, Cline, GitHub Copilot и VS Code. Те же инструменты доступны в терминале командой `cds-mcp` после глобальной установки пакета.
Для кого. Разработчикам на SAP CAP, которые пишут сервисы и модели CDS с помощью Claude Code, Codex или Copilot и хотят, чтобы агент знал их проект и актуальную документацию.
Подходит, если
- В проекте много сервисов CDS, и агенту надо понять, какие из них где раздаются
- Требуется найти сущность или определение по неполному имени в большой модели
- Агент пишет запрос на CAP Node.js и ошибается в API, поэтому нужна страница документации по смыслу
- Вы подключаете нового разработчика и просите агента объяснить связи между сущностями
- Хочется вызвать те же поиски из терминала без клиента MCP
Не подходит, если
- Проект не на SAP CAP: сервер знает только модель CDS и документацию CAP
- Нужна запись или изменение модели: инструменты только ищут и ничего не пишут
- Нужны стабильные интерфейсы для скриптов: автор отмечает, что инструменты рассчитаны на модели ИИ и не образуют стабильного API
Пример запроса к агенту
Какие сервисы CDS есть в этом проекте и где они раздаются? Потом покажи, как добавить столбец в select в CAP Node.js.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
CDS_MCP_MODEL- Модель эмбеддингов для поиска по документации, например nomic-ai/nomic-embed-text-v1.5.
Ограничения
Инструменты предназначены для моделей ИИ и не считаются стабильным API: их имена и параметры могут меняться. Сервер ищет по тому, что есть в проекте и во встроенной документации, и не заменяет сверку с официальным сайтом cap.cloud.sap.
Модель эмбеддингов можно сменить переменной `CDS_MCP_MODEL`, например на `nomic-ai/nomic-embed-text-v1.5`. Если пакет установлен глобально, `npx` использует установленную версию и не скачивает свежую, поэтому обновлять ее нужно вручную командой `npm update -g @cap-js/mcp-server`.
Для работы нужен установленный CAP по руководству Getting Started на сайте SAP. Вопросы о безопасности отправляются по процедуре раскрытия уязвимостей репозитория.
Как отключить. Удалите сервер командой `claude mcp remove cds-mcp` или уберите запись `cds-mcp` из конфигурации клиента. Глобальный пакет удаляется командой `npm uninstall -g @cap-js/mcp-server`.
Частые вопросы
Как подключить сервер к Claude Code?
Выполните `claude mcp add --scope user cds-mcp -- npx -y @cap-js/mcp-server` для всех проектов или с `--scope project` для текущего проекта в репозитории. Переменную окружения добавляют ключом `--env` перед именем сервера.
Работает ли он с Codex?
Да, команда `codex mcp add cds-mcp -- npx -y @cap-js/mcp-server`. В README есть блоки для VS Code, Cline, opencode и GitHub Copilot.
Что ищет search_docs?
Предобработанную документацию CAP через векторные эмбеддинги: запрос превращается в вектор, и возвращаются фрагменты, ближайшие по смыслу. Поиск идет локально на вашей машине, точные ключевые слова из документации не обязательны.
Что делает search_model?
Нечетко ищет по именам определений скомпилированной модели CDS: сущностям, сервисам, аннотациям и эндпоинтам. Частичное имя вроде «book» находит сущность Books.
Можно ли пользоваться без агента?
Да. После `npm i -g @cap-js/mcp-server` появляется команда `cds-mcp`: например, `cds-mcp search_docs "запрос" 1` или `cds-mcp search_model . Books entity`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер документации SAP: единый поиск по SAPUI5, CAP, ABAP, BTP и RAP с полнотекстовым ранжированием BM25.
SAP Fiori MCP Server — приложения Fiori с ИИ
SAP Fiori MCP Server
Официальный MCP-сервер SAP: агент создает и правит приложения SAP Fiori elements по описанию на обычном языке
MCP-сервер к SAP ABAP через ADT: агент читает код программ, классов, таблиц, CDS и ищет объекты в системе
ARC-1: MCP-сервер для систем SAP ABAP с защитой по умолчанию, чтением, правкой кода, транспортами и проверкой через ADT.
add-mcp одной командой прописывает MCP-сервер в конфигурации 25 агентов: Claude Code, Codex, Cursor, VS Code, Zed и других
MCP-сервер, который дает агенту читать файлы, искать по коду и запускать команды в рабочей папке
Коротко о README
Короткое описание сервера, список вопросов, на которые он помогает ответить, и настройка для Claude Code, VS Code, Codex и opencode. Затем описаны оба инструмента, использование из командной строки, переменные окружения, JavaScript API и порядок обращений в поддержку.