Btp Sap Odata To MCP Server Optimized

🚀 SAP OData 到 AI 驅動的 MCP 服務器（優化版）

本倉庫是一個企業級的 MCP（模型上下文協議）服務器，它將 SAP OData 服務與人工智能能力相連接。該優化版本基於 @lemaiwo 的原項目 btp - sap - odata - to - mcp - server 開發，具備增強的安全性、簡化的配置、模塊化的認證以及全面的 Cloud Foundry 集成等特性。

✨ 主要特性

🔐 增強的安全架構

• 模塊化認證系統：採用工廠模式，支持 IAS、OAuth2、JWT、基本認證和 API 密鑰。
• 安全會話管理：通過適當的鎖定機制實現線程安全的會話橋接。
• 基於角色的訪問控制：與 XSUAA 集成，實現細粒度的權限管理。
• 主體傳播：在整個請求生命週期中維護用戶上下文。
• 安全最佳實踐：不記錄敏感數據，進行安全的錯誤處理和 JWT 驗證。

🎯 簡化的 OData 發現

• 基於模式的過濾：使用簡單的包含/排除模式進行服務發現。
• 業務領域模式：預配置的領域（銷售、財務、人力資源等）。
• 白名單模式：在生產環境中對服務進行明確控制。
• 智能默認設置：自動排除測試/調試服務。

🧠 人工智能驅動的能力

• 智能查詢路由器：將自然語言轉換為 OData 查詢。
• 分層工具架構：17 種以上的工具按邏輯層組織。
• 智能工作流編排：自動進行工具鏈和優化。
• 即時分析：KPI 監控和趨勢分析。

🎨 交互式 UI 工具套件

• ui - form - generator：帶有驗證功能的動態 SAP Fiori 表單。
• ui - data - grid：具有排序和過濾功能的交互式表格。
• ui - dashboard - composer：即時 KPI 儀表盤。
• ui - workflow - builder：可視化工作流創建。
• ui - report - builder：支持向下鑽取的分析報告。

☁️ 雲原生特性

• Cloud Foundry 優化：與 CF 服務進行原生集成。
• 結構化日誌記錄：支持 SAP 雲日誌記錄並具備回退支持。
• 健康監控：全面的健康檢查端點。
• 性能指標：內置性能跟蹤。
• 優雅關閉：正確清理資源。

🚀 快速開始

前提條件

• 能夠訪問 SAP BTP 的 Cloud Foundry 環境。
• 需要的 BTP 服務：XSUAA、Identity、Connectivity、Destination。
• Node.js 版本 >= 18。

1. 安裝

git clone <this-repo>
cd btp-sap-odata-to-mcp-server-optimized
npm install

2. 配置

使用環境變量配置應用程序。詳細文檔請參閱 配置指南。

cp .env.example .env
# 使用你的配置編輯 .env

快速配置示例

# 認證
SAP_IAS_URL=https://your-tenant.accounts.ondemand.com
SAP_IAS_CLIENT_ID=your-client-id
SAP_IAS_CLIENT_SECRET=your-secret

# OData 發現（簡化）
ODATA_DISCOVERY_MODE=pattern
ODATA_INCLUDE_PATTERNS=*API*,Z*
ODATA_EXCLUDE_PATTERNS=*_TEST*,*_TEMP*
ODATA_MAX_SERVICES=50

# 目標系統
SAP_DESTINATION_NAME=SAP_S4HANA

3. 構建和部署

# 為 BTP 構建 TypeScript 源代碼
npm run build:btp

# 部署到 SAP BTP 的 Cloud Foundry
npm run deploy:btp

📚 詳細文檔

項目的各個方面都有完整的文檔，並提供結構化導航。

🏠 文檔中心

主導航中心，提供基於用例的指南和完整的文件索引。

🚀 快速鏈接

📖 導航流程

README.md → docs/README.md → 所有文檔
     ↓           ↓
快速開始 → 結構化導航 → 全面覆蓋