sap-abap-mcp

A custom MCP server that connects IBM Bob to any SAP ABAP system via SOAP/RFC and SAP WebGUI (ITS).

No SAP system details are hardcoded — everything is configured through environment variables, so each user connects to their own system with their own credentials.

---

Prerequisites

• Node.js v18 or later
• Git (to clone)
• IBM Bob IDE extension installed
• A valid SAP user account on the target system

---

Setup (first time)

Option A — via npx (easiest, no clone needed)

No installation required. Just set your environment variables (Step 3 below) and open the folder in Bob — npx will automatically download and run the latest version.

Option B — via GitHub clone (for development / offline use)

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

Then in .bob/mcp.json, change the command from npx to node and args to ["./build/index.js"].

3. Set your SAP connection details as environment variables

These five variables tell the server which SAP system to connect to and how to log in. Each person sets their own — never share credentials.

Variable	Required	Description	Example
SAP_WEBGUI_URL	✅ Yes	Full WebGUI URL of your SAP system	https://your-sap-host/sap/bc/gui/sap/its/webgui
SAP_CLIENT	✅ Yes	SAP client number	100
SAP_USERNAME	✅ Yes	Your SAP username	JSMITH
SAP_PASSWORD	✅ Yes	Your SAP password	MyPass123
SAP_LANGUAGE	❌ Optional	Logon language (default: EN)	EN

Windows PowerShell — add to your $PROFILE for persistence:

$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 — add to ~/.zshrc or ~/.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"

⚠️ The server will refuse to start and print a clear error message if any required variable is missing.

4. Open the sap-abap-mcp folder in Bob

Bob automatically detects .bob/mcp.json in the workspace root and connects to the server. The SAP tools will appear in Bob's tool list immediately.

---

Available tools

Tool	Description
sap_login	Log in via SAP WebGUI (establishes a session)
sap_navigate	Navigate to any SAP transaction code (SE16, SM30, SU01, …)
sap_se16_browse	Browse any transparent SAP table — no login required
sap_rfc_read_table	Full-power table reader: field selection, WHERE filters, pagination
sap_run_report	Run an ABAP report/program via SA38
sap_execute_command	Send an OK-code / transaction command to the current WebGUI session
sap_get_page	Fetch any SAP WebGUI URL and return the rendered page text

---

Example prompts in 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

---

How it works

• SOAP/RFC (sap_rfc_read_table, sap_se16_browse): Uses RFC_READ_TABLE via SOAP with HTTP Basic Auth — stateless, no login session needed.
• WebGUI session (sap_login, sap_navigate, etc.): Performs a full login via SAP ITS WebGUI and keeps session cookies in a local temp file.

---

Project structure

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

---

Rebuilding after source changes

npm run build

Then in Bob: Settings → MCP → Restart server.

---

Updating to the latest version

git pull
npm install
npm run build

---

Security notes

• ✅ No credentials or system URLs are hardcoded anywhere in the source.
• ✅ .gitignore excludes build/, node_modules/, session files, and data dumps.
• ✅ .bob/mcp.json contains only ${ENV_VAR} placeholders — safe to commit to Git.
• ⚠️ Never add real credentials to any file that gets committed to Git.