sap-s4hana-odata-mcp

An MCP (Model Context Protocol) server for querying SAP S/4HANA Business Partner data via OData V2 API. Connects directly to on-premise S/4HANA systems using Basic Authentication.

Tools

Setup

npm install
cp .env.example .env   # then edit with your S/4HANA connection details
npm run build

Configuration

All settings are in .env:

Port Calculation

The HTTP/HTTPS port is derived from the system number:

• HTTPS port = 443 + system number (e.g. sysnr 50 -> port 44350)
• HTTP port = 80 + system number (e.g. sysnr 50 -> port 8050)

Finding Your Connection Details

Run transaction SMICM in SAP GUI to find the hostname, system number, and active ports:

1. Open SAP GUI and enter tcode SMICM
2. Go to Goto > Services to see the list of active HTTP/HTTPS services
3. Note the hostname and port numbers — the system number is the last two digits of the port (e.g. port 44350 means sysnr 50)

Usage with Claude Code

Add to .claude.json:

{
  "mcpServers": {
    "s4hana-bp": {
      "command": "node",
      "args": ["/path/to/sap-s4hana-odata-mcp/dist/index.js"]
    }
  }
}

Example Queries

List first 10 business partners:

Show me the first 10 business partners

Search by name:

Find business partners with "SAP" in the name

Filter by category (1=Person, 2=Organization):

List all person-type business partners

Get details with address:

Get business partner 21 with their address

Tech Stack

• TypeScript
• MCP SDK
• Axios for OData HTTP calls
• Zod for input validation
• dotenv for configuration

License

MIT