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.
