mcp-server

mcp-server — MCP-сервер сообщества (автор — cap-js). Сервер для разработки приложений SAP CAP с ИИ. Лицензия Apache-2.0.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
cap-js
Лицензия
Apache-2.0
Транспорт
stdio
Авторизация
none
ОС
Не указана
Языки
javascript

Уровень риска: medium

Читает CDS-модель проекта, загружает эмбеддинги документации CAP; изменений не вносит.

Настройка клиентов

codex
{
    "code": "codex mcp add cds-mcp -- npx -y @cap-js/mcp-server",
    "lang": "bash",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

@cap-js/mcp-server — официальный MCP-сервер для SAP Cloud Application Programming Model (CAP). Он нужен для разработки CAP-приложений с ИИ-агентом: модель находит определения CDS в проекте и ищет по документации CAP, а не угадывает API.

Сервер помогает отвечать на вопросы вроде: какие CDS-сервисы есть в проекте и где они опубликованы, что означают сущности и как они связаны, как добавить колонки в select в CAP Node.js.

Инструменты:

  • search_model — нечёткий поиск по именам определений в скомпилированной модели CDS (Core Schema Notation). Модель объединяет все .cds-файлы: определения и связи, аннотации, HTTP-эндпоинты. Поиск по «book» найдёт сущность Books.
  • search_docs — семантический поиск по заранее подготовленной документации CAP с помощью векторных эмбеддингов. Запрос превращается в вектор, и система находит самые близкие по смыслу фрагменты — всё локально на вашем компьютере. По умолчанию остаются фрагменты для рантайма проекта (Node.js или Java) и общие.

Экспериментальные переменные окружения управляют офлайн-режимом с локальным кэшем эмбеддингов (CDS_MCP_OFFLINE, CDS_MCP_OFFLINE_DIR), моделью эмбеддингов (CDS_MCP_MODEL), лимитом результатов и необязательным переранжированием локальной моделью cross-encoder (CDS_MCP_RERANK_ENABLED).

README рекомендует добавить в AGENTS.md правила: искать определения CDS через сервер и читать .cds-файлы только при неудаче, а перед любыми изменениями моделей и вызовами API CAP сверяться с документацией через сервер.

Кому подойдёт

  • Разработчикам SAP CAP на Node.js и Java.
  • Командам SAP BTP, использующим ИИ-агентов в разработке.
  • Новичкам в CAP, которым нужна документация прямо в ассистенте.

Похожие серверы — в категории разработка.

Установка

Сервер запускается командой npx -y @cap-js/mcp-server — её нужно указать в MCP-клиенте (Cline, opencode, Claude Code, GitHub Copilot и другие). Для прямого вызова инструментов из терминала установите пакет глобально: npm i -g @cap-js/mcp-server, после чего появится команда cds-mcp. При глобальной установке npx использует её, поэтому обновляйте пакет вручную через npm update -g @cap-js/mcp-server.

Подключение к клиентам

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

claude mcp add --scope user cds-mcp -- npx -y @cap-js/mcp-server

Для Claude Code есть также области проекта: без --scope (локально, без коммита) и --scope project (сохраняется в репозитории). VS Code-конфиг — это глобальный mcp.json, который GitHub Copilot использует в режиме агента. Для opencode README приводит команду opencode mcp add --global cds-mcp -- npx -y @cap-js/mcp-server.

Проверка

Спросите: «Какие CDS-сервисы есть в этом проекте и где они опубликованы?» — сработает search_model.

Примеры задач

Как добавить колонки в select в CAP Node.js? Найди в документации и покажи пример.
Опиши сущности проекта и связи между ними.

Риски

  • Чтение проекта. Сервер компилирует и читает CDS-модель текущего проекта.
  • Сеть. Сервер загружает подготовленные эмбеддинги документации; офлайн-режим использует локальный кэш.
  • Изменений не вносит. Оба инструмента только ищут; README отмечает, что инструменты не являются стабильным API.

Частые вопросы

Уходит ли документация в облако при поиске?

Нет, семантический поиск выполняется локально на вашем компьютере.

Можно ли работать без интернета?

Да, переменная CDS_MCP_OFFLINE=true включает локальный кэш эмбеддингов.

Поддерживается ли CAP Java?

Да, search_docs учитывает рантайм проекта — Node.js или Java.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

Everything

Эталонный тестовый сервер, который демонстрирует все возможности протокола MCP.

Риск: medium Лицензия: NOASSERTION ★ 92 089

Time

Эталонный сервер для получения текущего времени и перевода между часовыми поясами.

Риск: medium Лицензия: NOASSERTION ★ 92 089

Reactive Resume

Открытый конструктор резюме с удалёнными MCP-инструментами для резюме и откликов.

Риск: medium Лицензия: MIT ★ 45 567

AIHOT

Новости ИИ на китайском: темы, события и сводки.

Риск: medium Лицензия: MIT ★ 9 672

Источники