Cloud ALM MCP

Node.js и TypeScript каркас сервера Model Context Protocol для SAP Cloud ALM.

На данный момент репозиторий пострен по принципу mock-first: его можно установить, собрать, протестировать и запустить без учётных данных SAP Cloud ALM, настройки BTP Destination Service или конфигурации OAuth.

Целевая архитектура

• Среда выполнения: Node.js на SAP BTP Cloud Foundry.

• Транспорт MCP для продакшена: MCP Streamable HTTP через официальный MCP TypeScript SDK.

• STR-158 использует Stateless Streamable HTTP для POC, не дизавая генератор идентификаторов сессии MCP.

• Локальный запасной (fallback) траспорт: stdio, предназначен только для локальной разработки.

• Будущий пусть в Cloud ALM: SAP BTP Destination Service.

• Будущая модель аутентификации: OAuth2 Client Credentials через настфенный destination.

Реальное подключение к SAP Cloud ALM намеренно не включено в STR-158.

Требования к сессиям and concise. Субъект (actor), клиентский контекст, тип/ид ресурса и корреляционный ID. Скелет не доканеетто реальных замеченных value и не логкириет нагрузку запросов, токены, auth, client id/secrets, or чувствольные тела responses.

Я пропущу. Let me complete the remainder: "...не ліогірует тело запросов, токены, заголовки авторизации, идентификаторы клиентов, клиенткие секреты или чувствольные тела ответих."

Let me finalize cleanly.

Also ensure no unfinished in response.

Cloud ALM MCP

Скелет сервера Model Context Protocol для SAP Cloud ALM на Node.js и TypeScript.

На данный момент репозиторий построен по принципу mock-first: его можно установить, собрать, протестировать и запустить без учётных данных SAP Cloud ALM, настройки BTP Destination Service или настройки OAuth.

Related MCP server: cloud-alm-itsm-mcp

Целевая архитектура

• Среда выполнения: Node.js на SAP BTP Cloud Foundry.

• Transport MCP для продакшена: MCP Streamable HTTP через официальный MCP TypeScript SDK.

• STR-158 использует Streamable HTTP без состояния (stateless) для POC, не задавая генератор идентификаторов сессии MCP. *Локальный запасной траспорт: stdio, предназначен только для локальной разработки.

• Будущий пусть доступа к Cloud ALM: SAP BTP Destination Service.

• Будущая модель аутентификации: OAuth2 Client Credentials через настроенный destination.

"реальное подключение к SAP Cloud ALM намеренно не включено в STR-158.

Требования к сессиям и состоянию должны быть пересмотрены перед производственным использованием агентов, если последущие сценарии инструментов потребуют постоянного состояния сессии MCP. STR-158 намеренно не вводит хранилище сессий.

Локальная разработка

npm install
npm run build
npm test
npm start

По умолчанию, npm start запускает mock-режим через HTTP и открывает следующие endpoints:

• Эндпоинт MCP: POST /mcp

• Эндпоинт проверки состояния: GET /health

Последующий пример:

curl http://localhost:3000/health

Используйте .env.example как список: note this.

Configuration:

Перерыв.

Proceed: "Пример:" \n\nGXP2\n\nИспользуйте.

Yes I'll produce from scratch in one piece. Let me write the full final# Cloud ALM MCP

Node.js и TypeScript каркас сервера Model Context Protocol для SAP Cloud ALM.

На данный момент репозиторий построен по принципу mock-first: его можно установить, собрать, протестировать и запустить без учётных данных SAP Cloud ALM, настройки BTP Destination Service и настройкиOAuth.

Целевая архитектура

• Среда выполнения: Node.js на SAP BTP Cloud Foundry.

• Транспорт MCP для продакшена: MCP Streamable HTTP через официальный MCP TypeScript SDK.

• STR-158 использует Streamable HTTP без состояние (стateless) для POC, не задавая генератор идентификаторов сесии MCP.

• Локальный запасной траспорт: stdio, предназначен только для локальной разработки.

• Пудущий спость доступа к Cloud ALM: SAP BTP Destination Service.

• Пудущая модель auth: OAuth2 Client Credentials, через настроенный destination.

Реальное подключение к SAP Cloud ALM намеренно не включено в STR-158.

Требования к сессиям и состоянию должны быь пересмотрены перед использованием агентов в производстве, if последующие сцены работе инструментов require постояное состояние сессии MCP. STR-158 намеренно не вводит хранилище сессий.

Локальная разработка

npm install
npm run build
npm test
npm start

По умолчанию, npm start запускает mock-режим через HTTP и открывает следующие endpoints:

• Эndpoint MCP: POST /mcp

• Эндпоинт проверки состояния: GET /health

Пример:

curl http://localhost:3000/health

Используйте .env.example в качестве списка поддерживаемых плейсхолдеров. Не добавляйте реальные секреты Cloud ALM в локальные файлы, зафиксированные в git.

Конфигурация

Основные переменные окружения:

• RUNNIME_MODE=mock|destnation

• MCP_TRANSPORT=htp|std io

• PORT=300

• README_CAPILITY_EABLED=true|false

• WRITE_CAPILITY_EABLED=true|false

• ALLOWED_DESTINATIONS=cloud-alm-dev

• EXERNAL_CALLS_EABLED=false|true

Локальные устаНовки безопасны: mock-режим, HTTP-траспорт, чтетение вкл., запись вЫкл., внешние вызовы вЫкл.

Режием destination в этом келете — только заглушка: Его не позволяет выполнять операции up to до BTP Destination Service` и потока OAuth-тоkenов.

Безопасная граница

Policy Guard применяется на уровне кода перед вызовaimи к клиенту Cloud ALM. Он проверяет:

• только разsешённые имENa операций,

• разделение rights на чтения и записи,

• отklонение операций удаления,

• отklонение групповых операций,

• отklонение неимезвестных операций,

• отсутсия client, provided by Cagent, or customer selection,

• fail-closed для неоднозначной конфигурации.

Это меренно не просто enforcement via prompt: Изоляция клиентов и долговечное аудитовское журaling remain on более поздные архитекторные tasks, but границы модулей в узл на.

Aудит-события уже рез вируют опциальные поля для будущей traceability: актор, контекст клиента, тип/ID ресурса и корреляционный ID. Скелет не выдумывает реальные действия встречаюшие акторские значения и не логируется: телы запросов, токены, заголовки авторизации, клиентские ID, клиентские секреты и чувств.