SAP S/4HANA采购订单MCP服务器
使用SAP云应用程序编程模型（CAP）构建的模型上下文协议（MCP）服务器，为Claude Desktop等AI代理提供SAP S/4HANA采购订单API。
概述
该项目提供了一个MCP服务器，该服务器连接到SAP S/4HANA后端系统，并通过模型上下文协议公开采购订单数据和操作。它使AI代理能够直接从对话界面查询、创建、更新和删除采购订单。
特性
- 完整的CRUD操作：查询、创建、更新和删除采购订单
- 多个实体：访问采购订单、项目、注释、明细表行、帐户分配、定价元素和分包组件
- 自定义函数：用于常见操作的预构建功能，如按供应商搜索、计算总计和查找待处理订单
- MCP提示：用于复杂采购订单分析的即用型提示模板
- OData v2支持：与SAP S/4HANA OData v2 API兼容，具有自动日期时间格式修复功能
- Cloud Foundry就绪：可部署到SAP BTP Cloud Foundry环境
建筑
┌─────────────────┐
│ Claude Desktop │
│ (AI Agent) │
└────────┬────────┘
│ MCP Protocol
│
┌────────▼────────┐
│ CAP MCP │
│ Server │
└────────┬────────┘
│ OData v2
│
┌────────▼────────┐
│ SAP S/4HANA │
│ Backend │
└─────────────────┘先决条件
- Node.js 18+和npm
- SAP云应用程序编程模型CLI(
@sap/cds-dk) - MTA构建工具(
mbt) - Cloud Foundry命令行界面(
cf) - 使用采购订单API访问SAP S/4HANA系统
- Claude Desktop（用于使用AI代理进行测试）
安装
- 克隆存储库：
git clone https://github.com/Logali-Group/cap-mcp-s4.git
cd cap-mcp-s4- 安装依赖项：
npm install- 在中配置您的SAP S/4HANA目标
package.json:
{
"cds": {
"requires": {
"API_PURCHASEORDER": {
"kind": "odata-v2",
"model": "srv/external/API_PURCHASEORDER",
"[development]": {
"credentials": {
"destination": "YOUR_DESTINATION_NAME",
"path": "/sap/opu/odata/sap/API_PURCHASEORDER_PROCESS_SRV"
}
}
}
}
}
}本地开发
- 在本地启动CAP服务器：
npm start- 使用MCP检查器测试MCP服务器：
npm run inspect- 对于自动重新加载的开发：
npm run watch部署到Cloud Foundry
- 构建MTA存档：
mbt build -t ./mta_archives- 部署到Cloud Foundry：
cf deploy ./mta_archives/mcp_cap2_1.0.0.mtar- 检查部署日志：
cf logs mcp_cap-srv --recentClaude桌面集成
- 从以下位置安装Claude Desktop claude.ai
- 在Claude Desktop设置中配置MCP服务器：
{
"mcpServers": {
"s4-purchase-orders": {
"url": "https://your-app.cfapps.region.hana.ondemand.com/mcp"
}
}
}- 重新启动Claude Desktop以连接到MCP服务器
可用实体
- 采购订单：主采购订单表头数据
- 采购订单项目：采购订单中的行项目
- 采购订单备注：标题级别注释
- 采购订单项目注释：项目级注释
- 采购订单明细表：交货时间表
- 采购订单账户分配：成本会计任务
- 采购订单定价要素：定价条件
- 分包后组件：分包组件数据
自定义函数
搜索采购订单供应商
通过可选的日期范围过滤按供应商搜索采购订单。
// Example usage
searchPurchaseOrdersBySupplier({
supplier: "0000100000",
dateFrom: "2024-01-01",
dateTo: "2024-12-31"
})getPurchaseOrderTotal
计算包含所有项目的特定采购订单的总金额。
// Example usage
getPurchaseOrderTotal({
purchaseOrder: "4500000132"
})获取挂起的采购订单
检索待批准或状态不完整的采购订单。
// Example usage
getPendingPurchaseOrders({
purchasingOrganization: "1000",
limit: 50
})MCP提示模板
服务器包括预构建的提示模板，用于：
- 分析采购订单的全部细节
- 比较供应商绩效
- 生成摘要报告
- 查找待审批
- 物资采购分析
- 价格差异分析
- 创建新的采购订单
技术实现
OData v2日期时间修复
该服务器包括从OData v4转换时OData v2日期时间格式问题的解决方法。axios拦截器会自动修复格式错误的日期时间字符串：
// Fixes: datetime'2025-08-01T00:00:00ZT00:00:00' (invalid)
// To: datetime'2025-08-01T00:00:00' (valid)认证
该项目支持多种身份验证模式：
- 发展：模拟身份验证
- 生产：基于XSUAA的JWT令牌身份验证
项目结构
.
├── app/ # UI applications (optional)
├── db/ # Database models (optional)
├── srv/
│ ├── sapbackend.cds # Service definitions and MCP annotations
│ ├── sapbackend.js # Service implementation
│ └── external/ # External service definitions
├── mta.yaml # Multi-Target Application descriptor
├── package.json # Project configuration
└── xs-security.json # XSUAA security configuration配置
MCP服务器设置（package.json）
{
"cds": {
"mcp": {
"name": "s4-purchase-order-mcp",
"version": "1.0.0",
"auth": "none",
"instruction": "Use this MCP server to query and retrieve purchase orders from SAP S/4 HANA backend system.",
"wrap_entities_to_actions": true,
"wrap_entity_modes": ["query", "get", "create", "update", "delete"]
}
}
}故障排除
401未经授权的错误
- 检查您的目标配置
- 验证身份验证凭据
- 确保XSUAA服务已正确绑定
日期时间格式错误
- 服务器自动修复OData v2日期时间问题
- 检查日志
[sapbackend] Fixed datetime format in URL
MCP连接问题
- 重新启动Claude Desktop以重新加载配置
- 验证MCP服务器URL是否可访问
- 检查Cloud Foundry应用程序日志
贡献
欢迎投稿！请按照以下步骤操作：
- 分叉存储库
- 创建要素分支
- 进行更改
- 提交拉取请求
许可证
此项目根据未授权许可证获得许可-有关详细信息，请参阅项目元数据。
资源
支持
对于问题和疑问：
- 在此存储库中打开问题
- 访问 洛加利集团