sap-frun-mcp

Unified MCP server for SAP Focused Run — 38 tools in one package, covering every SAP Focused Run functional area via WebGUI, SOAP/RFC, and OData REST.

Merges sap-frd-mcp (WebGUI + SOAP/RFC) and frun-frd-mcp (OData) into a single, zero-config server.

⚠️ This server connects to your own SAP Focused Run instance. You must supply credentials via environment variables. No data is sent anywhere except your SAP system.

Tools (38 total)

WebGUI + SOAP/RFC (8 tools)

| Tool | Description | |---|---| | sap_connection_manager | Add, list, switch, test, or delete named SAP connections | | 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 |

OData REST — FRUN Functional Areas (30 tools)

| Area | Tools | |---|---| | EarlyWatch Alert | frun_ewa_systems | | Landscape / LMDB | frun_landscape_systems, frun_landscape_instances, frun_landscape_topology, frun_landscape_reporting, frun_landscape_dr | | Config & Security Analytics | frun_csa_config_stores, frun_csa_policy_results, frun_csa_cova_commands | | Alert Management | frun_alerts_ticker, frun_alerts_notification_variants, frun_alerts_job_definitions | | System Monitoring | frun_sysmon_system_list, frun_sysmon_system_details, frun_sysmon_overview, frun_sysmon_admon | | Job Monitoring | frun_jobmon_runtime, frun_jobmon_setup, frun_jobmon_scope, frun_jobmon_service | | Metrics | frun_metrics_custom, frun_metrics_reporting | | Notifications / Work Mode | frun_notifications, frun_workmode | | Security / SSI | frun_security_ssi | | Solution Focus Manager | frun_sfm_dashboard, frun_sfm_status | | Inventory | frun_inventory | | Status Events | frun_status_events | | OData Discovery | frun_odata_catalogue |

Requirements

• Node.js ≥ 18
• A running SAP Focused Run instance (tested on FRUN 4.x / 2025)
• SAP user with read access to WebGUI and OData services

Installation

npm install -g sap-frun-mcp

Or use directly via npx (no install needed):

npx sap-frun-mcp

Configuration

Set these environment variables before starting the server:

| Variable | Required | Description | |---|---|---| | SAP_URL | ✅ | Full WebGUI URL, e.g. https://your-frun-host/sap/bc/gui/sap/its/webgui | | SAP_USERNAME | ✅ | Your SAP username | | SAP_PASSWORD | ✅ | Your SAP password | | SAP_CLIENT | ➖ | SAP client number (default: 100) | | SAP_LANGUAGE | ➖ | Logon language (default: EN) | | SAP_CERT_PATH | ➖ | Path to a custom CA certificate PEM (overrides the bundled cert) |

The non-prod FRD system URL (https://nonprodfrun.hec.edst.ibm.com) and client (100) are pre-configured as defaults. Only SAP_USERNAME and SAP_PASSWORD are required for FRD.

Usage with IBM Bob

Add to your Bob mcp.json (~/.bob/settings/mcp.json):

{
  "mcpServers": {
    "sap-frun-mcp": {
      "command": "npx",
      "args": ["-y", "sap-frun-mcp"],
      "env": {
        "SAP_USERNAME": "your-username",
        "SAP_PASSWORD": "your-password"
      }
    }
  }
}

For a different FRUN host (e.g. Production):

{
  "mcpServers": {
    "sap-frun-mcp": {
      "command": "npx",
      "args": ["-y", "sap-frun-mcp"],
      "env": {
        "SAP_URL":      "https://your-prod-frun-host/sap/bc/gui/sap/its/webgui",
        "SAP_USERNAME": "your-username",
        "SAP_PASSWORD": "your-password",
        "SAP_CERT_PATH": "/path/to/your-prod-cert.pem"
      }
    }
  }
}

Usage with Claude Desktop

{
  "mcpServers": {
    "sap-frun-mcp": {
      "command": "npx",
      "args": ["-y", "sap-frun-mcp"],
      "env": {
        "SAP_USERNAME": "your-username",
        "SAP_PASSWORD": "your-password"
      }
    }
  }
}

Example interactions

• "Log in to SAP FRD"
• "Show me all company codes in table T001"
• "What is the EWA report status this week?"
• "Are there any RED alerts in FRUN right now?"
• "List all managed systems in the FRUN landscape"
• "Show job monitoring status overview"
• "Run report RSUSR200"
• "List all OData services available on this FRUN gateway"

Migration from previous packages

This package replaces both sap-frd-mcp and frun-frd-mcp. Both are now deprecated.

Before (two entries):

"sap-frd-mcp":  { "command": "npx", "args": ["-y", "sap-frd-mcp"],  "env": {...} },
"frun-frd-mcp": { "command": "npx", "args": ["-y", "frun-frd-mcp"], "env": {...} }

After (one entry):

"sap-frun-mcp": { "command": "npx", "args": ["-y", "sap-frun-mcp"], "env": {...} }

TLS / Self-signed certificates

The package bundles the FRUN non-prod certificate (certs/frun-cert-0.pem) and pins it by fingerprint. For a different host, set SAP_CERT_PATH to that system's certificate path.

License

ISC