SAP OData to MCP Server

# SAP OData MCP Server - Documentation ## Table of Contents ### Getting Started - [Local Development Guide](./LOCAL_RUN.md) - Running the server locally - [Deployment Guide](./DEPLOYMENT.md) - Deploying to SAP BTP ### Architecture & Design - **[3-Level Progressive Discovery](./THREE_LEVEL_APPROACH.md)** - Core architecture (RECOMMENDED) - [Microsoft Copilot Compatibility](./MICROSOFT_COPILOT_COMPATIBILITY.md) - Optimizations for Copilot - [Service Discovery Configuration](./SERVICE_DISCOVERY_CONFIG.md) - Configuring service discovery ### Legacy Documentation - [Two-Tool Intelligent Approach](./TWO_TOOL_INTELLIGENT_APPROACH.md) - Previous 2-tool architecture (deprecated) - [Three-Tool Approach](./THREE_TOOL_APPROACH.md) - Intermediate 3-tool design (deprecated) --- ## Quick Links ### For Users 1. Start with [LOCAL_RUN.md](./LOCAL_RUN.md) to get the server running 2. Understand the [3-Level Architecture](./THREE_LEVEL_APPROACH.md) 3. Deploy using [DEPLOYMENT.md](./DEPLOYMENT.md) ### For Developers 1. Review [THREE_LEVEL_APPROACH.md](./THREE_LEVEL_APPROACH.md) for architecture details 2. Check [hierarchical-tool-registry.ts](../src/tools/hierarchical-tool-registry.ts) for implementation 3. See [MICROSOFT_COPILOT_COMPATIBILITY.md](./MICROSOFT_COPILOT_COMPATIBILITY.md) for LLM optimizations --- ## Architecture Overview The SAP OData MCP Server uses a **3-level progressive discovery architecture**: ``` Level 1: discover-sap-data � (minimal data for decision) Level 2: get-entity-metadata � (full schema details) Level 3: execute-sap-operation � (actual operation) ``` ### Benefits - **90% less tokens** in initial discovery - **Progressive detail** - fetch schemas only when needed - **Clear workflow** - Discovery � Understanding � Execution - **Better LLM experience** - smaller responses, clearer workflow See [THREE_LEVEL_APPROACH.md](./THREE_LEVEL_APPROACH.md) for complete details. --- ## Contributing When updating documentation: 1. Update relevant .md files in `/docs` 2. Update main [README.md](../README.md) if needed 3. Keep code examples accurate 4. Test with actual LLMs when possible --- ## Questions? - Check the main [README.md](../README.md) - Review [THREE_LEVEL_APPROACH.md](./THREE_LEVEL_APPROACH.md) - See implementation in [hierarchical-tool-registry.ts](../src/tools/hierarchical-tool-registry.ts)