btp-sap-odata-to -optimized

This MCP server bridges SAP OData services with AI-powered capabilities by discovering OData sources, routing requests through a modular authentication layer, and enabling AI-assisted tooling workflows. The server exposes an integrated set of 17+ tools organized in logical layers to perform tasks such as smart query routing, natural language to OData conversion, and workflow orchestration. Use the built-in UI tool suite (ui-form-generator, ui-data-grid, ui-dashboard-composer, ui-workflow-builder, ui-report-builder) to configure interfaces, forms, dashboards, and reports for your SAP data and AI workflows. Ensure your environment is prepared with SAP IAS/XSUAA authentication, OData discovery patterns, and destinations, then start the server to access both the OData endpoints and the AI-enabled tooling stack. The documentation hub provides detailed usage scenarios, including how to authenticate, discover services, and compose AI-driven workflows with the provided tools.

Prerequisites:

• Node.js (v18 or newer)
• npm (v6+)
• Access to SAP BTP, Cloud Foundry environment or equivalent
• SAP IAS/XSUAA configured (clientId, clientSecret, and URL)

1. Clone the repository

git clone <this-repo>
cd btp-sap-odata-to-optimized

2. Install dependencies

npm install

3. Configure environment Copy the example env and edit with your values

cp .env.example .env

4. Build the server (TypeScript to JS)

npm run build:btp

5. Run the server

npm start

6. Validate deployment

curl -i http://localhost:3000/health

Notes:

• The server expects environment variables as described in the Configuration guide. See docs/CONFIGURATION.md for detailed options.
• In production, wire up proper CF services, logging, and health probes as described in Deployment docs.

Tips and common issues:

• Ensure SAP IAS URL, clientId, and clientSecret are correct; invalid credentials will cause authentication failures.
• If OData discovery fails, verify ODATA_DISCOVERY_MODE and pattern strings (ODATA_INCLUDE_PATTERNS, ODATA_EXCLUDE_PATTERNS).
• Enable structured logging to SAP Cloud Logging for better observability.
• For stable sessions, ensure proper secret rotation and secure storage of credentials.
• If upgrading, review Changes/Changelog for breaking changes in tool APIs or authentication flows.