SAP Documentation MCP Server

A fast, lightweight MCP server that provides unified access to official SAP documentation (SAPUI5, CAP, OpenUI5 APIs & samples, wdi5) using efficient BM25 full-text search. Use it remotely (hosted URL) or run it locally.

Public server (MCP Streamable HTTP): https://mcp-sap-docs.marianzeis.de/mcp
Local Streamable HTTP (default: 3122, configurable via MCP_PORT): http://127.0.0.1:3122/mcp
Local HTTP status: http://127.0.0.1:3001/status

Quick start

https://mcp-sap-docs.marianzeis.de/mcp

# Should return JSON with api_last_activity
curl -sS https://mcp-sap-docs.marianzeis.de/status | jq .

# Should return HTTP 410 with migration info (SSE endpoint deprecated)
curl -i https://mcp-sap-docs.marianzeis.de/sse

# From repo root
npm ci
./setup.sh # execute this script to clone the github documentation submodules
npm run build

# Start the MCP server (STDIO)
node dist/src/server.js

# OR start the Streamable HTTP server
npm run start:streamable

# HTTP server
curl -sS http://127.0.0.1:3001/status | jq .

# Streamable HTTP server (local & deployment default)
curl -sS http://127.0.0.1:3122/health | jq .

What you get

🔍 Unified Documentation Search

• search – Search across all official SAP documentation sources with intelligent filtering
• fetch – Retrieve complete documents/snippets with smart formatting

🌐 Community & Help Portal

• sap_community_search – Real-time SAP Community posts with full content of top 3 results (intelligently truncated to 75k chars if needed)
• sap_help_search – Comprehensive search across SAP Help Portal documentation
• sap_help_get – Retrieve complete SAP Help pages with metadata (intelligently truncated to 75k chars if needed)

Connect from your MCP client

✅ Remote URL: use the public MCP Streamable HTTP endpoint
✅ Local/STDIO: run node dist/src/server.js and point the client to a command + args
✅ Local/Streamable HTTP: run npm run start:streamable and point the client to http://127.0.0.1:3122/mcp

Below are copy-paste setups for popular clients. Each block has remote, local, and streamable HTTP options.

Claude (Desktop / Web "Connectors")

https://mcp-sap-docs.marianzeis.de/mcp

command: node
args: ["<absolute-path-to-your-repo>/dist/src/server.js"]

npm run start:streamable

http://127.0.0.1:3122/mcp

Cursor

{
  "mcpServers": {
    "sap-docs-remote": {
      "url": "https://mcp-sap-docs.marianzeis.de/mcp"
    }
  }
}

{
  "mcpServers": {
    "sap-docs": {
      "command": "node",
      "args": ["/absolute/path/to/dist/src/server.js"]
    }
  }
}

Eclipse (GitHub Copilot)

Eclipse users can integrate the SAP Docs MCP server with GitHub Copilot for seamless access to SAP development documentation.

How do I implement a Wizard control in UI5?
What is the syntax for inline declarations in ABAP 7.58?
Show me best practices for RAP development
Find wdi5 testing examples for OData services

{
  "name": "SAP Docs MCP (Local)",
  "description": "Local SAP documentation server",
  "command": "npm", 
  "args": ["start"],
  "cwd": "/absolute/path/to/your/sap-docs-mcp",
  "env": {
    "NODE_ENV": "production"
  }
}

VS Code (GitHub Copilot Chat)

{
  "servers": {
    "sap-docs": {
      "type": "http",
      "url": "https://mcp-sap-docs.marianzeis.de/mcp"
    }
  }
}

{
  "servers": {
    "sap-docs-local": {
      "type": "stdio",
      "command": "node",
      "args": ["<absolute-path>/dist/src/server.js"]
    }
  }
}

{
  "servers": {
    "sap-docs-http": {
      "type": "http", 
      "url": "http://127.0.0.1:3122/mcp"
    }
  }
}

Raycast

{
  "mcpServers": {
    "sap-docs": {
      "command": "npx",
      "args": ["mcp-remote@latest", "https://mcp-sap-docs.marianzeis.de/mcp"]
    }
  }
}

{
  "mcpServers": {
    "sap-docs": {
      "command": "node",
      "args": ["/absolute/path/to/dist/src/server.js"]
    }
  }
}

Raycast by default asks to confirm each usage of an MCP tool. You can enable automatic confirmation:

Open Raycast → Raycast Settings → AI → Model Context Protocol → Check "Automatically confirm all tool calls"

Features

🔍 Advanced Search Capabilities

• Unified search across all official SAP documentation with intelligent ABAP version filtering
• BM25 full-text search with SQLite FTS5 for fast, relevant results (~15ms average query time)
• Context-aware scoring with automatic stopword filtering and phrase detection
• Version-specific filtering - shows latest ABAP by default, specific versions only when requested

🌐 Real-time External Integration

• SAP Community: Full content retrieval using "Best Match" algorithm with engagement metrics
• SAP Help Portal: Direct API access to all SAP product documentation (S/4HANA, BTP, Analytics Cloud)
• Efficient processing: Batch content retrieval and intelligent caching for fast response times

💡 Smart Features

• Automatic content enhancement: Code highlighting and sample categorization
• Intelligent ranking: Context-aware scoring with source-specific weighting
• Performance optimized: Lightweight SQLite FTS5 with no external ML dependencies

What's Included

This MCP server provides unified access to comprehensive SAP development documentation across multiple product areas. All sources are searched simultaneously through the search tool, with intelligent filtering and ranking.

📊 Documentation Coverage Overview

🔍 ABAP Development Sources

• Official ABAP Keyword Documentation (/abap-docs) - 40,761+ curated ABAP files across 8 versions (7.52-7.58 + latest) with intelligent version filtering
  📁 GitHub: marianfoo/abap-docs
• ABAP Cheat Sheets (/abap-cheat-sheets) - 32 comprehensive cheat sheets covering core ABAP concepts, SQL, OOP, RAP, and more
  📁 GitHub: SAP-samples/abap-cheat-sheets
• ABAP RAP Fiori Elements Showcase (/abap-fiori-showcase) - Complete annotation reference for ABAP RESTful Application Programming (RAP)
  📁 GitHub: SAP-samples/abap-platform-fiori-feature-showcase
• DSAG ABAP Guidelines (/dsag-abap-leitfaden) - German ABAP community best practices and development standards
  📁 GitHub: 1DSAG/ABAP-Leitfaden

🎨 UI5 Development Sources

• SAPUI5 Documentation (/sapui5-docs) - 1,485+ files - Complete official developer guide, controls, and best practices
  📁 GitHub: SAP-docs/sapui5
• OpenUI5 Framework (/openui5) - 20,000+ files - Complete OpenUI5 source including 500+ control APIs with detailed JSDoc and 2,000+ working examples from demokit samples
  📁 GitHub: SAP/openui5
• UI5 TypeScript Integration (/ui5-typescript) - Official TypeScript setup guides, type definitions, and migration documentation
  📁 GitHub: UI5/typescript
• UI5 Tooling (/ui5-tooling) - Complete UI5 Tooling documentation for project setup, build, and development workflows
  📁 GitHub: SAP/ui5-tooling
• UI5 Web Components (/ui5-webcomponents) - 4,500+ files - Comprehensive web components documentation, APIs, and implementation examples
  📁 GitHub: SAP/ui5-webcomponents
• UI5 Custom Controls (/ui5-cc-spreadsheetimporter) - Spreadsheet importer and other community custom control documentation
  📁 GitHub: spreadsheetimporter/ui5-cc-spreadsheetimporter

☁️ CAP Development Sources

• CAP Documentation (/cap-docs) - 195+ files - Complete Cloud Application Programming model documentation for Node.js and Java
  📁 GitHub: cap-js/docs
• CAP Fiori Elements Showcase (/cap-fiori-showcase) - Comprehensive annotation reference and examples for CAP-based Fiori Elements applications
  📁 GitHub: SAP-samples/fiori-elements-feature-showcase

🚀 Cloud & Deployment Sources

• SAP Cloud SDK for JavaScript (/cloud-sdk) - Complete SDK documentation, tutorials, and API references for JavaScript/TypeScript
  📁 GitHub: SAP/cloud-sdk
• SAP Cloud SDK for Java (/cloud-sdk) - Comprehensive Java SDK documentation and integration guides
  📁 GitHub: SAP/cloud-sdk
• SAP Cloud SDK for AI (/cloud-sdk-ai) - Latest AI capabilities integration documentation for both JavaScript and Java
  📁 GitHub: SAP/ai-sdk
• Cloud MTA Build Tool (/cloud-mta-build-tool) - Complete documentation for Multi-Target Application development and deployment
  📁 GitHub: SAP/cloud-mta-build-tool

✅ Testing & Quality Sources

• wdi5 Testing Framework (/wdi5) - 225+ files - End-to-end testing documentation, setup guides, and real-world examples
  📁 GitHub: ui5-community/wdi5
• SAP Style Guides (/sap-styleguides) - Official SAP coding standards, clean code practices, and development guidelines
  📁 GitHub: SAP/styleguides

Example Prompts

Try these with any connected MCP client to explore the comprehensive documentation:

🔍 ABAP Development Queries

ABAP Keyword Documentation (8 versions with intelligent filtering):

• "What is the syntax for inline declarations in ABAP 7.58?"
• "How do I use SELECT statements with internal tables in ABAP 7.57?"
• "Show me exception handling with TRY-CATCH in modern ABAP"
• "What are constructor expressions for VALUE and CORRESPONDING?"
• "How do I implement ABAP Unit tests with test doubles?"

ABAP Best Practices & Guidelines:

• "What is Clean ABAP and how do I follow the style guide?"
• "Show me ABAP cheat sheet for internal tables operations"
• "Find DSAG ABAP guidelines for object-oriented programming"
• "How to implement RAP with EML in ABAP for Cloud?"

🎨 UI5 Development Queries

SAPUI5 & OpenUI5:

• "How do I implement authentication in SAPUI5?"
• "Find OpenUI5 button control examples with click handlers"
• "Show me fragment reuse patterns in UI5"
• "What are UI5 model binding best practices?"

Modern UI5 Development:

• "Show me TypeScript setup for UI5 development"
• "How do I configure UI5 Tooling for a new project?"
• "Find UI5 Web Components integration examples"
• "How to implement custom controls with UI5 Web Components?"

☁️ CAP & Cloud Development

CAP Framework:

• "How do I implement CDS views with calculated fields in CAP?"
• "Show me CAP authentication and authorization patterns"
• "Find CAP Node.js service implementation examples"
• "How to handle temporal data in CAP applications?"

Cloud SDK & Deployment:

• "How do I use SAP Cloud SDK for JavaScript with OData?"
• "Show me Cloud SDK for AI integration examples"
• "Find Cloud MTA Build Tool configuration for multi-target apps"
• "How to deploy CAP applications to SAP BTP?"

✅ Testing & Quality

Testing Frameworks:

• "Show me wdi5 testing examples for forms and tables"
• "How do I set up wdi5 for OData service testing?"
• "Find end-to-end testing patterns for Fiori Elements apps"

Code Quality:

• "What are SAP style guide recommendations for JavaScript?"
• "Show me clean code practices for ABAP development"

🌐 Community & Help Portal

Community Knowledge (with full content):

• "Find community examples of OData batch operations with complete implementation"
• "Search for RAP development tips and tricks from the community"
• "What are the latest CAP authentication best practices from the community?"

SAP Help Portal:

• "How to configure S/4HANA Fiori Launchpad?"
• "Find BTP integration documentation for Analytics Cloud"
• "Search for ABAP development best practices in S/4HANA"

Troubleshooting

curl -i https://mcp-sap-docs.marianzeis.de/mcp

node <absolute-path>/dist/src/server.js

node dist/src/server.js

pm2 status mcp-sap-http
pm2 status mcp-sap-proxy
curl -fsS http://127.0.0.1:3001/status | jq .
curl -fsS http://127.0.0.1:18080/status | jq .

Development

Build Commands

npm run build:tsc       # Compile TypeScript
npm run build:index     # Build search index from sources
npm run build:fts       # Build FTS5 database  
npm run build           # Complete build pipeline (tsc + index + fts)
npm run setup           # Complete setup (submodules + build)

Server Commands

npm start                    # Start STDIO MCP server
npm run start:http           # Start HTTP status server (port 3001)
npm run start:streamable     # Start Streamable HTTP MCP server (port 3122)

Local Setup

git clone https://github.com/marianfoo/mcp-sap-docs.git
cd mcp-sap-docs
npm ci               # Install dependencies
npm run setup        # Enhanced setup (optimized submodules + complete build)

The build process creates optimized search indices for fast offline access while maintaining real-time connectivity to the SAP Community API.

Health & Status Monitoring

Public Endpoints

# Check server status
curl -sS https://mcp-sap-docs.marianzeis.de/status | jq .

# Test MCP endpoint
curl -i https://mcp-sap-docs.marianzeis.de/mcp

Local Endpoints

# HTTP server status
curl -sS http://127.0.0.1:3001/status | jq .

# MCP Streamable HTTP server status  
curl -sS http://127.0.0.1:3122/health | jq .

Deployment

Automated Workflows

This project includes dual automated workflows:

1. Main Deployment (on push to main or manual trigger)

   • SSH into server and pull latest code
   • Run enhanced setup with optimized submodule handling
   • Restart all PM2 processes (http, streamable) with health checks

2. Daily Documentation Updates (4 AM UTC)

   • Update all documentation submodules to latest versions
   • Rebuild search indices with fresh content using enhanced setup
   • Restart services automatically

Manual Updates

Trigger documentation updates anytime via GitHub Actions → "Update Documentation Submodules" workflow.

Architecture

• MCP Server (Node.js/TypeScript) - Exposes Resources/Tools for SAP docs, community & help portal
• Streamable HTTP Transport (Latest MCP spec) - HTTP-based transport with session management and resumability
• BM25 Search Engine - SQLite FTS5 with optimized OR-logic queries for fast, relevant results
• Optimized Submodules - Shallow, single-branch clones with blob filtering for minimal bandwidth

Technical Stack

• Search Engine: BM25 with SQLite FTS5 for fast full-text search with OR logic
• Performance: ~15ms average query time with optimized indexing
• Transport: Latest MCP protocol with HTTP Streamable transport and session management