BelugaMCP

Unified SAP MCP monorepo — combining 3 SAP documentation projects into a single, extensible ecosystem.

BelugaMCP is the "canivete suíço" for SAP development via MCP (Model Context Protocol). Search SAP documentation, lint ABAP code, explore BTP services, and more — all from your AI assistant.

Variants

Variant	Focus	Sources	abap_lint	Discovery Center
sap-docs	Full SAP ecosystem (UI5, CAP, ABAP, BTP, ...)	29	❌	✅
abap	ABAP/RAP development	12	✅	✅

Quick Start

# Clone and setup
git clone https://github.com/anomalyco/BelugaMCP
cd BelugaMCP
./scripts/setup.sh

# (Optional) Generate ABAP keyword documentation
./scripts/run-pipeline.sh

# Build all packages
npm run build

# Start the sap-docs variant (stdio)
npm run dev:sap-docs

Configuration in Cursor / Claude Desktop

{
  "mcpServers": {
    "beluga-sap": {
      "command": "node",
      "args": ["packages/server-sap-docs/dist/index.js"],
      "env": { "MCP_VARIANT": "sap-docs" }
    }
  }
}

For ABAP:

{
  "mcpServers": {
    "beluga-abap": {
      "command": "node",
      "args": ["packages/server-abap/dist/index.js"],
      "env": { "MCP_VARIANT": "abap" }
    }
  }
}

Packages

Package	Type	Description
packages/abap-docs/	Data pipeline	Scraper + generator for ABAP Keyword Documentation (JS vanilla)
packages/server-core/	Core library	Shared MCP server code — handlers, search, metadata, URL generation
packages/server-sap-docs/	Wrapper	Thin entry point for the sap-docs variant
packages/server-abap/	Wrapper	Thin entry point for the abap variant

Available Tools

Tool	Description	sap-docs	abap
search	Hybrid search (FTS5 + semantic + online)	✅	✅
fetch	Full document retrieval	✅	✅
abap_lint	Static ABAP code analysis	❌	✅
abap_feature_matrix	ABAP feature availability by release	✅	✅
sap_community_search	SAP Community blog/Q&A search	✅	✅
sap_search_objects	SAP released objects search	✅	✅
sap_get_object_details	Released object details	✅	✅
sap_discovery_center_search	BTP service catalog search	✅	✅
sap_discovery_center_service	BTP service details	✅	✅

Scripts

Script	Description
npm run scrape	Scrape ABAP documentation from SAP Help
npm run generate	Generate Markdown from scraped HTML
npm run pipeline	Full scrape + generate pipeline
npm run run-pipeline	Full pipeline via shell script
npm run build	Build all packages (server-core → wrappers)
npm run dev:sap-docs	Dev mode with hot reload (sap-docs)
npm run dev:abap	Dev mode with hot reload (abap)
npm test	Run all tests

Architecture

See ARCHITECTURE.md for a deep dive into the monorepo structure, variant system, and data flow.

Credits

BelugaMCP is a unification of 3 open-source projects. See CREDITS.md for full attribution.

License

MIT — compatible with all original projects.