io.github.Raistlin82/btp-sap-odata-to-mcp-server-optimized

Enterprise SAP OData to MCP Server with AI capabilities and Cloud Foundry integration

What can you do with io.github.Raistlin82/btp-sap-odata-to-mcp-server-optimized?

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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package btp-sap-odata-to-mcp-server

Claude Code

claude mcp add btp-sap-odata-to-mcp-server-optimized -e 'SAP_IAS_URL=<SAP_IAS_URL>' -e 'SAP_IAS_CLIENT_ID=<SAP_IAS_CLIENT_ID>' -e 'SAP_IAS_CLIENT_SECRET=<your sap_ias_client_secret>' -e 'SAP_DESTINATION_NAME=<SAP_DESTINATION_NAME>' -e 'ODATA_DISCOVERY_MODE=<ODATA_DISCOVERY_MODE>' -e 'ODATA_INCLUDE_PATTERNS=<ODATA_INCLUDE_PATTERNS>' -e 'ODATA_EXCLUDE_PATTERNS=<ODATA_EXCLUDE_PATTERNS>' -e 'PORT=<PORT>' -e 'NODE_ENV=<NODE_ENV>' -- npx -y btp-sap-odata-to-mcp-server@1.0.1

JSON configuration (Claude Desktop, Cursor, VS Code)

{
    "mcpServers": {
        "btp-sap-odata-to-mcp-server-optimized": {
            "command": "npx",
            "args": [
                "-y",
                "btp-sap-odata-to-mcp-server@1.0.1"
            ],
            "env": {
                "SAP_IAS_URL": "<SAP_IAS_URL>",
                "SAP_IAS_CLIENT_ID": "<SAP_IAS_CLIENT_ID>",
                "SAP_IAS_CLIENT_SECRET": "<your sap_ias_client_secret>",
                "SAP_DESTINATION_NAME": "<SAP_DESTINATION_NAME>",
                "ODATA_DISCOVERY_MODE": "<ODATA_DISCOVERY_MODE>",
                "ODATA_INCLUDE_PATTERNS": "<ODATA_INCLUDE_PATTERNS>",
                "ODATA_EXCLUDE_PATTERNS": "<ODATA_EXCLUDE_PATTERNS>",
                "PORT": "<PORT>",
                "NODE_ENV": "<NODE_ENV>"
            }
        }
    }
}

Environment variables

SAP_IAS_URL required URL of the SAP Identity Authentication Service tenant
SAP_IAS_CLIENT_ID required Client ID for the OAuth application in IAS
SAP_IAS_CLIENT_SECRET required secret Client Secret for the OAuth application in IAS
SAP_DESTINATION_NAME required Name of the BTP destination used for service discovery
ODATA_DISCOVERY_MODE OData discovery mode: pattern, business, whitelist, or all
ODATA_INCLUDE_PATTERNS Comma-separated patterns to include (pattern mode)
ODATA_EXCLUDE_PATTERNS Comma-separated patterns to exclude (pattern mode)
PORT The port on which the Express server will listen
NODE_ENV The application's operating environment

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents

SAP OData to AI-Powered MCP Server (Optimized)
✨ Key Features
🚀 Quick Start
📚 Documentation

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 validation
ui-data-grid: Interactive tables with sorting and filtering
ui-dashboard-composer: Real-time KPI dashboards
ui-workflow-builder: Visual workflow creation
ui-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

git clone <this-repo>
cd btp-sap-odata-to-mcp-server-optimized
npm install

2. Configuration

Configure the application using environment variables. See the Configuration Guide for detailed documentation.

cp .env.example .env
# Edit .env with your configuration

Quick Configuration Example

# Authentication
SAP_IAS_URL=https://your-tenant.accounts.ondemand.com
SAP_IAS_CLIENT_ID=your-client-id
SAP_IAS_CLIENT_SECRET=your-secret

# OData Discovery (Simplified)
ODATA_DISCOVERY_MODE=pattern
ODATA_INCLUDE_PATTERNS=*API*,Z*
ODATA_EXCLUDE_PATTERNS=*_TEST*,*_TEMP*
ODATA_MAX_SERVICES=50

# Destinations
SAP_DESTINATION_NAME=SAP_S4HANA

3. Build and Deploy

# Build the TypeScript source code for BTP
npm run build:btp

# Deploy to SAP BTP, Cloud Foundry
npm run deploy:btp

📚 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	Configuration Guide	Environment setup, OData discovery, CF deployment
Architecture	Architecture Overview	System design, security model, tool hierarchy
🎨 Modern Diagrams	Modern Architecture Diagrams	NEW! Interactive visual architecture
Usage	User Guide	Authentication, tool usage, workflow examples
Reference	Tool Reference	Complete tool documentation with parameters
Deployment	Deployment Guide	SAP BTP and local development setup
Development	Testing Guide	Test suite and development guidelines
Changes	Changelog	Version history and feature updates

README.md → docs/README.md → All Documentation
     ↓           ↓
Quick Start → Structured Navigation → Complete Coverage

Frequently asked questions

What is io.github.Raistlin82/btp-sap-odata-to-mcp-server-optimized?

Enterprise SAP OData to MCP Server with AI capabilities and Cloud Foundry integration

How do I install io.github.Raistlin82/btp-sap-odata-to-mcp-server-optimized?

It runs on your machine. In Claude Code: claude mcp add btp-sap-odata-to-mcp-server-optimized -e 'SAP_IAS_URL=<SAP_IAS_URL>' -e 'SAP_IAS_CLIENT_ID=<SAP_IAS_CLIENT_ID>' -e 'SAP_IAS_CLIENT_SECRET=<your sap_ias_client_secret>' -e 'SAP_DESTINATION_NAME=<SAP_DESTINATION_NAME>' -e 'ODATA_DISCOVERY_MODE=<ODATA_DISCOVERY_MODE>' -e 'ODATA_INCLUDE_PATTERNS=<ODATA_INCLUDE_PATTERNS>' -e 'ODATA_EXCLUDE_PATTERNS=<ODATA_EXCLUDE_PATTERNS>' -e 'PORT=<PORT>' -e 'NODE_ENV=<NODE_ENV>' -- npx -y btp-sap-odata-to-mcp-server@1.0.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.Raistlin82/btp-sap-odata-to-mcp-server-optimized need an API key?

Yes. It expects SAP_IAS_URL, SAP_IAS_CLIENT_ID, SAP_IAS_CLIENT_SECRET, SAP_DESTINATION_NAME, which you set in its configuration.

Is io.github.Raistlin82/btp-sap-odata-to-mcp-server-optimized open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.Raistlin82/btp-sap-odata-to-mcp-server-optimized?

It is published by Raistlin82. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.

Server details

Listed in: Official MCP Registry
Publisher: Raistlin82
Category: AI and agents
Runs: Local
GitHub stars: ★ 6
License: MIT
Language: TypeScript
Last commit: Sep 25, 2025
Open issues: 0
Version: 1.0.1
Published: Sep 21, 2025

io.github.Raistlin82/btp-sap-odata-to-mcp-server-optimized

Similar servers

GreatWait Reliable one-off and recurring HTTPS callbacks for apps and agents.
longbook Your longbook of bills, subscriptions and expenses, for your AI to read and to suggest ...
SchoolScope California school data for AI agents — scores, comparisons, feeder paths, TK ages, appl...
Bot Office Report AI bot work to a live office; ask a person to approve risky actions; work queue ...
NannyKeeper Household Payroll & Taxes Calculate US household employer (nanny) taxes + run payroll via AI agents. All 50 states.
Ainoova Tools Notes, tasks, habits, journal and 6 more tools Claude can read and change, with undo. F...
Hookownia Polskie hooki, style i struktury rolek dla ChatGPT i Claude. Twój czat pisze z nimi skr...
Project Room — agent coordination Connect existing AI agents via OAuth or MCP; join a public lobby, find work and coordin...

AI and agents