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

Registre officiel IA et agents

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

Que pouvez-vous faire avec 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

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

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
Configuration JSON (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>"
            }
        }
    }
}

Variables d'environnement

  • SAP_IAS_URL obligatoire URL of the SAP Identity Authentication Service tenant
  • SAP_IAS_CLIENT_ID obligatoire Client ID for the OAuth application in IAS
  • SAP_IAS_CLIENT_SECRET obligatoire secret Client Secret for the OAuth application in IAS
  • SAP_DESTINATION_NAME obligatoire 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

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. SAP OData to AI-Powered MCP Server (Optimized)
  2. ✨ Key Features
  3. 🚀 Quick Start
  4. 📚 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.

CategoryDocumentDescription
Getting StartedConfiguration GuideEnvironment setup, OData discovery, CF deployment
ArchitectureArchitecture OverviewSystem design, security model, tool hierarchy
🎨 Modern DiagramsModern Architecture DiagramsNEW! Interactive visual architecture
UsageUser GuideAuthentication, tool usage, workflow examples
ReferenceTool ReferenceComplete tool documentation with parameters
DeploymentDeployment GuideSAP BTP and local development setup
DevelopmentTesting GuideTest suite and development guidelines
ChangesChangelogVersion history and feature updates
📖 Navigation Flow
README.md → docs/README.md → All Documentation
     ↓           ↓
Quick Start → Structured Navigation → Complete Coverage

Questions fréquentes

Qu'est-ce que io.github.Raistlin82/btp-sap-odata-to-mcp-server-optimized ?

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

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

Il s'exécute sur votre machine. Dans 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. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.Raistlin82/btp-sap-odata-to-mcp-server-optimized ?

Oui. Il attend SAP_IAS_URL, SAP_IAS_CLIENT_ID, SAP_IAS_CLIENT_SECRET, SAP_DESTINATION_NAME, à renseigner dans sa configuration.

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

Oui. Son code est sur GitHub sous licence MIT.

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

Il est publié par Raistlin82. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.