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

| Tool | Description | |------|-------------| | list_business_partners | List business partners with OData filtering, sorting, pagination, and field selection | | get_business_partner | Get a specific business partner by ID with optional $expand for addresses, roles, etc. |

Setup

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

Configuration

All settings are in .env:

| Variable | Required | Description | Example | |----------|----------|-------------|---------| | S4HANA_HOSTNAME | Yes | S/4HANA application server hostname | s4hana.example.com | | S4HANA_SYSNR | Yes | SAP system number (00-99) | 50 | | S4HANA_USE_HTTPS | No | Use HTTPS (default: true) | true | | S4HANA_USERNAME | Yes | SAP technical user | TECH_USER | | S4HANA_PASSWORD | Yes | Password | secret123 | | S4HANA_CLIENT | No | SAP client number | 001 | | S4HANA_ODATA_PATH | No | OData service path (default: /sap/opu/odata/sap/API_BUSINESS_PARTNER) | /sap/opu/odata/sap/API_BUSINESS_PARTNER |

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