This server bridges SAP OData services with AI capabilities through the Model Context Protocol (MCP), enabling intelligent data access, analysis, and business process automation.
Core Capabilities:
Secure SAP Integration: Modular authentication supporting IAS, OAuth2, JWT, Basic Auth, and API keys with role-based access control and principal propagation
Service Discovery: Pattern-based filtering and whitelisting for simplified SAP OData service exploration
Intelligent Querying: Natural language to OData conversion through Smart Query Router and Natural Query Builder
CRUD Operations: Direct create, read, update, and delete operations with optimized query performance
AI-Powered Analytics: Smart data analysis for patterns, trends, forecasts, correlations, and business process insights with predictive modeling
Real-time Data: WebSocket streaming for continuous SAP data updates with configurable frequency
Dynamic UI Generation: Create SAP Fiori-styled forms, data grids, dashboards, workflows, and drill-down reports
KPI Management: Comprehensive dashboard building and business intelligence reporting with real-time visualization
Cloud-Native Deployment: Optimized for SAP BTP Cloud Foundry with health monitoring, structured logging, and graceful shutdown
Enables natural language interactions with SAP S/4HANA or ECC systems by exposing all OData services as dynamic MCP tools, supporting CRUD operations on entities like customers, purchase orders, banks, and other business data through conversational queries.
SAP OData to AI-Powered MCP Server (Optimized)
This repository is an enterprise-ready MCP (Model Context Protocol) server that bridges SAP OData services with AI capabilities. Based on the original project btp-sap-odata-to-mcp-server by @lemaiwo, this optimized version features enhanced security, simplified configuration, modular authentication, and comprehensive Cloud Foundry integration.
✨ Key Features
🔐 Enhanced Security Architecture
Modular Authentication System: Factory pattern supporting IAS, OAuth2, JWT, Basic Auth, and API Keys
Secure Session Management: Thread-safe session bridging with proper locking mechanisms
Role-Based Access Control: Granular permissions with XSUAA integration
Principal Propagation: Maintains user context throughout the request lifecycle
Security Best Practices: No sensitive data logging, secure error handling, JWT validation
🎯 Simplified OData Discovery
Pattern-Based Filtering: Simple include/exclude patterns for service discovery
Business Domain Mode: Pre-configured domains (sales, finance, HR, etc.)
Whitelist Mode: Explicit service control for production environments
Smart Defaults: Automatic exclusion of test/debug services
🧠 AI-Powered Capabilities
Smart Query Router: Natural language to OData conversion
Hierarchical Tool Architecture: 17+ tools organized in logical layers
Intelligent Workflow Orchestration: Automatic tool chaining and optimization
Real-time Analytics: KPI monitoring and trend analysis
🎨 Interactive UI Tools Suite
ui-form-generator
: Dynamic SAP Fiori forms with validationui-data-grid
: Interactive tables with sorting and filteringui-dashboard-composer
: Real-time KPI dashboardsui-workflow-builder
: Visual workflow creationui-report-builder
: Analytical reports with drill-down
☁️ Cloud-Native Features
Cloud Foundry Optimized: Native integration with CF services
Structured Logging: SAP Cloud Logging with fallback support
Health Monitoring: Comprehensive health check endpoints
Performance Metrics: Built-in performance tracking
Graceful Shutdown: Proper resource cleanup
🚀 Quick Start
Prerequisites
Access to an SAP BTP, Cloud Foundry environment.
Required BTP services: XSUAA, Identity, Connectivity, Destination.
Node.js >= 18.
1. Installation
2. Configuration
Configure the application using environment variables. See the Configuration Guide for detailed documentation.
Quick Configuration Example
3. Build and Deploy
📚 Documentation
Complete documentation is available with structured navigation for all aspects of the project.
🏠 Documentation Hub
Main navigation center with use-case-based guidance and complete file index.
🚀 Quick Links
Category | Document | Description |
Getting Started | Environment setup, OData discovery, CF deployment | |
Architecture | System design, security model, tool hierarchy | |
🎨 Modern Diagrams | NEW! Interactive visual architecture | |
Usage | Authentication, tool usage, workflow examples | |
Reference | Complete tool documentation with parameters | |
Deployment | SAP BTP and local development setup | |
Development | Test suite and development guidelines | |
Changes | Version history and feature updates |
📖 Navigation Flow
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
Transforms SAP S/4HANA or ECC systems into conversational AI interfaces by exposing all OData services as dynamic MCP tools. Enables natural language interactions with ERP data including querying, creating, updating, and deleting entities through SAP BTP integration.