SAP Clean Core Server

An MCP (Model Context Protocol) server that classifies SAP ABAP objects against SAP's official Clean Core release catalog. Built for architects, developers, and consultants working on S/4HANA implementations.

What it does

Instantly classify any SAP object (BAPI, function module, CDS view, BDEF, table) against SAP's abap-atc-cr-cv-s4hc dataset — the same catalog that ATC (ABAP Test Cockpit) uses during transport checks.

> Classify BAPI_GOODSMVT_CREATE for PCE

BAPI_GOODSMVT_CREATE → Level C | Not in catalog | ATC Priority 2
I_PURCHASEORDER      → Level C | notToBeReleasedStable | ATC Priority 2  ← the trap
I_BUSINESSPARTNER    → Level A | released | Use freely ✓

Clean Core Levels

Level	State	ATC	Meaning
A	released	None	Released API — use freely
B	classicAPI / deprecated	Priority 3	Classic API — migration path exists
C	notToBeReleased / notToBeReleasedStable	Priority 2	Internal — exemption required
D	noAPI	Priority 1	No API exists — redesign required
C	Not in catalog	Priority 2	Defaults to C per SAP rule 3.3.4.3.3

Tools

Tool	Description
cc_classify_objects	Classify a list of objects — returns level, ATC priority, and recommended action
cc_lookup_object	Full detail lookup for a single object including successors
cc_find_successors	Find the released replacement API for a blocked object
cc_search_objects	Wildcard/prefix search across 44,000+ objects
cc_semantic_search	Natural language search ("goods movement posting API")
cc_search_by_component	Find all released APIs in a software/application component
cc_get_statistics	Dataset stats — level distribution, object types, top components
cc_list_object_types	All object types in the catalog with counts
cc_partner_objects	Query partner-extended release catalog
cc_explain_level	Explain what a Clean Core level means and what to do about it

Deployment Targets

• PCE — S/4HANA Private Cloud Edition (default)
• PUBLIC — S/4HANA Public Cloud
• BTP — BTP ABAP Environment

Dataset

Backed by SAP's official open-source release catalog: github.com/SAP/abap-atc-cr-cv-s4hc

• 44,541 objects across S4CORE, SAP_ABA, SAP_BASIS and partner namespaces
• Updated with each SAP release
• Loaded at startup, cached in-memory — no database required

Quick Start

git clone https://github.com/Nidhideep/sap-clean-core-mcp
cd sap-clean-core-mcp
npm install
npm run build
npm run setup    # creates .env and .mcp.json

Register with Claude Code:

claude mcp add --scope user sap-clean-core -- node /path/to/sap-clean-core-mcp/dist/src/index.js

Or add to your .mcp.json:

{
  "mcpServers": {
    "sap-clean-core": {
      "command": "node",
      "args": ["/path/to/sap-clean-core-mcp/dist/src/index.js"],
      "env": {
        "DEFAULT_TARGET": "PCE"
      }
    }
  }
}

Environment Variables

Variable	Default	Description
DEFAULT_TARGET	PCE	Default deployment target (PCE/PUBLIC/BTP)
DISABLE_EMBEDDINGS	false	Set true to skip semantic search index
FETCH_TIMEOUT_MS	60000	GitHub dataset fetch timeout
LOG_LEVEL	info	Set debug for verbose logs

Requirements

• Node.js 18+
• Internet access at startup (fetches SAP dataset from GitHub)

License

MIT