Back to Browse

Btp Sap Odata To Mcp Server Optimized MCP Server

Business ToolsModerate7.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

7.0
Moderate7.0Low Risk

Valid MCP server (1 strong, 1 medium validity signals). 3 known CVEs in dependencies (0 critical, 3 high severity) Package registry verified. Imported from the Official MCP Registry.

6 files analyzed ยท 4 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

env_vars

Check that this permission is expected for this type of plugin.

Shell Command Execution

Runs commands on your machine. Be cautious โ€” only use if you trust this plugin.

What You'll Need

Set these up before or after installing:

URL of the SAP Identity Authentication Service tenantOptional

Environment variable: SAP_IAS_URL

Client ID for the OAuth application in IASOptional

Environment variable: SAP_IAS_CLIENT_ID

Client Secret for the OAuth application in IASRequired

Environment variable: SAP_IAS_CLIENT_SECRET

Name of the BTP destination used for service discoveryOptional

Environment variable: SAP_DESTINATION_NAME

OData discovery mode: pattern, business, whitelist, or allOptional

Environment variable: ODATA_DISCOVERY_MODE

Comma-separated patterns to include (pattern mode)Optional

Environment variable: ODATA_INCLUDE_PATTERNS

Comma-separated patterns to exclude (pattern mode)Optional

Environment variable: ODATA_EXCLUDE_PATTERNS

The port on which the Express server will listenOptional

Environment variable: PORT

The application's operating environmentOptional

Environment variable: NODE_ENV

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-raistlin82-btp-sap-odata-to-mcp-server-optimized": {
      "env": {
        "PORT": "your-port-here",
        "NODE_ENV": "your-node-env-here",
        "SAP_IAS_URL": "your-sap-ias-url-here",
        "SAP_IAS_CLIENT_ID": "your-sap-ias-client-id-here",
        "ODATA_DISCOVERY_MODE": "your-odata-discovery-mode-here",
        "SAP_DESTINATION_NAME": "your-sap-destination-name-here",
        "SAP_IAS_CLIENT_SECRET": "your-sap-ias-client-secret-here",
        "ODATA_EXCLUDE_PATTERNS": "your-odata-exclude-patterns-here",
        "ODATA_INCLUDE_PATTERNS": "your-odata-include-patterns-here"
      },
      "args": [
        "-y",
        "btp-sap-odata-to-mcp-server"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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

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

Reviews

No reviews yet

Be the first to review this server!

Btp Sap Odata To Mcp Server Optimized MCP Server - Enterprise SAP OData to MCP Server with AI capabilities and | MCP Marketplace