sap-odata

This MCP server provides a bridge between SAP OData services and AI assistants by exposing a set of tools that can query, manipulate, and interact with SAP OData endpoints. Key capabilities include discovering available OData services, fetching service metadata, querying entity sets with filtering, sorting, and pagination, performing CRUD operations on entities, calling OData function imports, and handling CSRF tokens for secured write operations. The server is designed with a modular TypeScript codebase to ensure clean separation of concerns between the HTTP client, request handlers, and tool definitions. You can integrate the server with Claude or other LLM-based assistants by configuring Claude's desktop or cloud settings to point at the MCP server and exposing tools such as sap_connect, sap_query_entity_set, sap_get_service_metadata, sap_get_services, and more for natural language-driven SAP data access.

Prerequisites

• Node.js 18+
• Access to SAP OData endpoints and valid credentials
• Network connectivity from the server to SAP OData services

Quick Setup

1. Create a project directory and initialize it (example):

mkdir sap-odata-mcp-server
cd sap-odata-mcp-server
npm init -y

2. Install dependencies (as per your package.json in the repo):

npm install

3. Configure environment variables. Create a .env file or use the example provided in README:

cp .env.example .env
# Edit .env with your SAP details

4. Build the project (if TypeScript is used):

npm run build

5. Run the MCP server locally for testing:

npm run start

6. Integrate with Claude Desktop by pointing the MCP server configuration in Claude to the built index.js with appropriate environment variables, as shown in the README example.

Environment variable tips:

• SAP_ODATA_BASE_URL should be the base URL of your SAP OData service (ending with / for the OData root).
• SAP_VALIDATE_SSL controls whether SSL certificates are validated; set to false only in development with self-signed certs.
• SAP_ENABLE_CSRF enables automatic CSRF token handling for write operations; ensures safer CRUD calls.
• If you encounter 404s when calling the base URL, verify the SAP OData service paths and ensure the base URL is reachable from the MCP server.
• The tools support a range of operations: connect to SAP OData, discover services, retrieve service metadata, query entity sets with filters and pagination, CRUD operations, function imports, and connection status checks.
• For Claude integration, configure the environment block in Claude to pass SAP credentials securely; avoid hard-coding credentials in code.

Common issues:

• Network/firewall blocking access to SAP OData endpoints
• Incorrect SAP client or credentials causing authentication failures
• SSL certificate issues when SAP uses self-signed certs (adjust SAP_VALIDATE_SSL accordingly)