SAP OData to MCP Server

SAP OData到AI驱动的MCP服务器（优化）

此存储库是一个企业就绪的MCP（模型上下文协议）服务器，它将SAP OData服务与AI功能连接起来。基于原始项目 btp sap odata到mcp服务器 通过@lemaiwo，这个优化版本具有增强的安全性、简化的配置、模块化身份验证和全面的Cloud Foundry集成。

✨ 主要特点

🔐 增强的安全架构

• 模块化身份验证系统：支持IAS、OAuth2、JWT、基本Auth和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、身份、连接、目标。
• Node.js>=18。

1.安装

git clone 
cd btp-sap-odata-to-mcp-server-optimized
npm install

2.配置

使用环境变量配置应用程序。请参阅 配置指南 详细文档。

cp .env.example .env
# Edit .env with your configuration

快速配置示例

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

# OData Discovery (Simplified)
ODATA_DISCOVERY_MODE=pattern
ODATA_INCLUDE_PATTERNS=*API*,Z*
ODATA_EXCLUDE_PATTERNS=*_TEST*,*_TEMP*
ODATA_MAX_SERVICES=50

# Destinations
SAP_DESTINATION_NAME=SAP_S4HANA

3.构建和部署

# Build the TypeScript source code for BTP
npm run build:btp

# Deploy to SAP BTP, Cloud Foundry
npm run deploy:btp

📚 文档

完整的文档可用于项目各个方面的结构化导航。

🏠 文档中心

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

🚀 快速链接

📖 导航流

README.md → docs/README.md → All Documentation
     ↓           ↓
Quick Start → Structured Navigation → Complete Coverage