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 → 所有文档
     ↓           ↓
快速开始 → 结构化导航 → 全面覆盖