Сервер MCP (Model Context Protocol) на основе конфигурации, который предоставляет API OData и REST в качестве инструментов MCP. Это позволяет ИИ-помощникам, таким как Клод, запрашивать, управлять и контролировать серверы SAP с помощью естественного языка.

Сервер работает на SAP BTP Cloud Foundry и использует BTP Destinations для безопасного подключения к API OData.

Особенности

32 набора объектов OData в 6 категориях API, автоматически регистрируемых как инструменты MCP ** Полная поддержка CRUD** - список, получение, создание, обновление и удаление операций, где API позволяет

• ** Возможности запроса OData V2** – $filter, $select, $expand, $orderby, $top, $skip и $inlinecount Прохождение навигационного свойства - выделенные инструменты для связанных с ними объектов (например, конфигурации iFlow, вложения сообщений, детали ошибок) ** Фильтрация на основе категории ** - включите только те категории API, которые вам нужны. -Двухместный транспорт- Потоковый HTTP для развертывания BTP, stdio для локального использования Claude Desktop ** Автоматическое управление токенами OAuth** - токены обновляются прозрачно через службу назначения BTP

Архитектура

OData MCP Proxy

A config-driven MCP (Model Context Protocol) server that exposes OData and REST APIs as MCP tools. This enables AI assistants such as Claude to query, manage, and monitor SAP backends through natural language.

The server runs on SAP BTP Cloud Foundry and uses BTP Destinations for secure, token-managed connectivity to OData APIs.

---

Features

• 32 OData entity sets across 6 API categories, automatically registered as MCP tools
• Full CRUD support – list, get, create, update, and delete operations where the API permits
• OData V2 query capabilities – $filter, $select, $expand, $orderby, $top, $skip, and $inlinecount
• Navigation property traversal – dedicated tools for related entities (e.g., iFlow configurations, message attachments, error details)
• Category-based filtering – enable only the API categories you need via configuration
• Dual transport modes – Streamable HTTP for BTP deployment, stdio for local Claude Desktop use
• Automatic OAuth token management – tokens are refreshed transparently via the BTP Destination Service

---

Architecture

Claude / AI Assistant
        |
        | MCP Protocol (stdio or HTTP)
        v
 OData MCP Proxy
        |
        | OData V2 + JSON
        v
   OData Client
        |
        | OAuth2 (via BTP Destination Service)
        v
  BTP Destination
        |
        v
 SAP Cloud Integration
   OData Admin APIs

The server resolves a BTP Destination at startup to obtain the Cloud Integration tenant URL and OAuth2 credentials. On each API call, the destination is re-resolved to ensure tokens remain valid. The OData client translates MCP tool invocations into OData V2 HTTP requests and returns structured JSON results to the AI assistant.

---

Prerequisites

• Node.js 20+ (18+ minimum, 20+ recommended)
• SAP BTP account with a Cloud Foundry environment
• SAP Integration Suite tenant (Cloud Integration capability)
• BTP Destination configured to point to your Cloud Integration tenant’s OData API with OAuth2 authentication
• Cloud Foundry CLI (cf) and MBT Build Tool (mbt) for BTP deployment

---

Quick Start (Local Development)

1. Clone and install

git clone 
cd odata-mcp-proxy
npm install

2. Configure environment

cp .env.example .env

Edit .env and set at minimum:

SAP_DESTINATION_NAME=your_ci_destination_name
MCP_TRANSPORT=stdio

Note: For local development with stdio transport, you must have BTP Destination Service credentials available in your environment (e.g., via VCAP_SERVICES or a default-env.json file).

3. Build and run

npm run build
npm run start:stdio

Or use the development watcher:

npm run dev

4. Connect from Claude Desktop

Add the server to your Claude Desktop MCP configuration (claude_desktop_config.json):

{