sap-abap-mcp

Кастомный MCP-сервер, который подключает IBM Bob к любой системе SAP ABAP через SOAP/RFC и SAP WebGUI (ITS).

Никакие данные о системе SAP не захардкожены — всё настраивается через переменные окружения, поэтому каждый пользователь подключается к своей собственной системе со своими учётными данными.

Предварительные требования

• Node.js v18 или новее

• Git (для клонирования)

• Установленное расширение IDE IBM Bob

• Действительная учётная запись SAP в целевой системе

Related MCP server: MCP SAP GUI Server

Настройка (при первом запуске)

Вариант A — через npx (самый простой, клонирование не требуется)

Установка не требуется. Просто задайте переменные окружения (шаг 3 ниже) и откройте папку в Bob — npx автоматически загрузит и запустит последнюю версию.

Вариант Б — через клонирование с GitHub (для разработки / автономного использования)

git clone https://github.com/JayGandhi285/sap-abap-mcp.git
cd sap-abap-mcp
npm install
npm run build

Затем в .bob/mcp.json измените команду с npx на node, а аргументы — на ["./build/index.js"].

3. Укажите данные подключения к SAP в переменных окружения

Эти пять переменных сообщают серверу, к какой системе SAP подключаться и как выполнить вход. Каждый пользователь задаёт свои собственные — никогда не делитесь учётными данными.

Windows PowerShell — добавьте в свой $PROFILE для постоянного хранения:

$env:SAP_WEBGUI_URL = "https://your-sap-host/sap/bc/gui/sap/its/webgui"
$env:SAP_CLIENT     = "100"
$env:SAP_USERNAME   = "your_sap_username"
$env:SAP_PASSWORD   = "your_sap_password"
$env:SAP_LANGUAGE   = "EN"

Mac / Linux — добавьте в ~/.zshrc или ~/.bashrc:

export SAP_WEBGUI_URL="https://your-sap-host/sap/bc/gui/sap/its/webgui"
export SAP_CLIENT="100"
export SAP_USERNAME="your_sap_username"
export SAP_PASSWORD="your_sap_password"
export SAP_LANGUAGE="EN"

⚠️ Если какая-либо обязательная переменная отсутствует, сервер откажется запускаться и выведет понятное сообщение об ошибке.

4. Откройте папку sap-abap-mcp в Bob

Bob автоматически обнаруживает .bob/mcp.json в корне рабочей области и подключается к серверу. Инструменты SAP немедленно появятся в списке инструментов Bob.

Доступные инструменты

Примеры запросов в Bob

Show me all users in the SAP system
Read table T001 and show the company codes
Show me all failed background jobs
List all transport requests owned by RAJAT

Как это работает

• SOAP/RFC (sap_rfc_read_table, sap_se16_browse): использует RFC_READ_TABLE через SOAP с HTTP Basic Auth — не сохраняет состояние, сеанс входа не требуется.

• WebGUI-сеанс (sap_login, sap_navigate и т.д.): выполняет полный вход через SAP ITS WebGUI и сохраняет файлы cookie сеанса в локальном временном файле.

Структура проекта

sap-abap-mcp/
├── src/
│   └── index.ts          ← MCP server source (TypeScript)
├── build/
│   └── index.js          ← Compiled output (generated — not in Git)
├── .bob/
│   └── mcp.json          ← Bob MCP config (all placeholders — safe to share)
├── .gitignore
├── package.json
├── tsconfig.json
└── README.md

Пересборка после изменения исходного кода

npm run build

Затем в Bob: Настройки → MCP → Перезапустить сервер.

Обновление до последней версии

git pull
npm install
npm run build

Примечания по безопасности

• ✅ Никакие учётные данные или URL систем не захардкожены нигде в исходном коде.

• ✅ .gitignore исключает build/, node_modules/, файлы сеансов и дампы данных.

• ✅ .bob/mcp.json содержит только заполнители ${ENV_VAR} — это безопасно для коммита в Git.

• ⚠️ Никогда не добавляйте реальные учётные данные в файлы, которые попадают в коммиты Git.