sap-abap-mcp

Un servidor MCP personalizado que conecta IBM Bob a cualquier sistema SAP ABAP mediante SOAP/RFC y SAP WebGUI (ITS).

No hay detalles del sistema SAP codificados de forma fija: todo se configura mediante variables de entorno, de modo que cada usuario se conecta a su propio sistema con sus propias credenciales.

Requisitos previos

• Node.js v18 o posterior

• Git (para clonar)

• Extensión IBM Bob instalada en el IDE

• Una cuenta de usuario SAP válida en el sistema de destino

Related MCP server: MCP SAP GUI Server

Configuración (primera vez)

Opción A — mediante npx (la más sencilla, sin necesidad de clonar)

No se requiere instalación. Solo tienes que configurar tus variables de entorno (paso 3 a continuación) y abrir la carpeta en Bob: npx descargará y ejecutará automáticamente la última versión.

Opción B — mediante clonación de GitHub (para desarrollo / uso sin conexión)

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

Luego, en .bob/mcp.json, cambia el comando de npx a node y los argumentos a ["./build/index.js"].

3. Configura los detalles de conexión a SAP como variables de entorno

Estas cinco variables indican al servidor a qué sistema SAP conectarse y cómo iniciar sesión. Cada persona configura las suyas propias: nunca compartas credenciales.

Windows PowerShell — añádelas a tu $PROFILE para que persistan:

$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 — añádelas a ~/.zshrc o ~/.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"

⚠️ El servidor se negará a iniciarse y mostrará un mensaje de error claro si falta alguna variable obligatoria.

4. Abre la carpeta sap-abap-mcp en Bob

Bob detecta automáticamente .bob/mcp.json en la raíz del espacio de trabajo y se conecta al servidor. Las herramientas de SAP aparecerán inmediatamente en la lista de herramientas de Bob.

Herramientas disponibles

Ejemplos de prompts en 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

Cómo funciona

• SOAP/RFC (sap_rfc_read_table, sap_se16_browse): utiliza RFC_READ_TABLE mediante SOAP con autenticación básica HTTP: sin estado, no se necesita sesión de inicio de sesión.

• Sesión WebGUI (sap_login, sap_navigate, etc.): realiza un inicio de sesión completo mediante SAP ITS WebGUI y mantiene las cookies de sesión en un archivo temporal local.

Estructura del proyecto

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

Reconstrucción tras cambios en el código fuente

npm run build

Luego, en Bob: Configuración → MCP → Reiniciar servidor.

Actualización a la última versión

git pull
npm install
npm run build

Notas de seguridad

• ✅ No hay credenciales ni URLs de sistema codificadas de forma fija en el código fuente.

• ✅ .gitignore excluye build/, node_modules/, archivos de sesión y volcados de datos.

• ✅ .bob/mcp.json contiene solo marcadores de posición ${ENV_VAR}: seguro para confirmar en Git.

• ⚠️ Nunca añadas credenciales reales a ningún archivo que se confirme en Git.