Sap MCP

🚀 SAP MCP服务器和客户端

本项目提供了通过RESTful API与SAP系统交互的MCP（Model Context Protocol）服务器和客户端实现，方便用户调用SAP函数并处理响应。

🚀 快速开始

安装

安装所需的依赖项（MCP SDK版本1.3.0或更高）：

pip install -r requirements.txt

配置

更新config.json文件中的SAP API连接详情：

{
  "sap_api": {
    "base_url": "http://192.168.1.129:8000/zmy_service",
    "client": "100",
    "username": "your_username",
    "password": "your_password"
  }
}

如果不需要身份验证，可以保留username和password字段不变或完全删除它们。

运行示例

运行客户端

运行客户端示例：

python sap_client.py

这将：

1. 启动MCP服务器。
2. 通过stdio连接到服务器。
3. 执行示例SAP函数调用。
4. 显示结果。

以HTTP模式运行服务器

以HTTP模式运行服务器：

python sap_server.py --transport http --host 127.0.0.1 --port 8000

使用HTTP客户端测试

使用HTTP客户端进行测试：

python simple_test.py

✨ 主要特性

• 提供MCP服务器和客户端实现，可通过RESTful API与SAP系统交互。
• 具备基本的错误处理机制，包括网络错误、JSON解析错误和缺少函数名称等。
• 支持直接使用call_sap_function工具调用SAP函数。

📦 安装指南

安装所需的依赖项（MCP SDK版本1.3.0或更高）：

pip install -r requirements.txt

💻 使用示例

基础用法

运行客户端示例：

python sap_client.py

高级用法

以HTTP模式运行服务器：

python sap_server.py --transport http --host 127.0.0.1 --port 8000

直接使用MCP工具

MCP服务器提供了一个名为call_sap_function的工具，具有以下参数：

• function_name（字符串，必需）：要调用的SAP函数名称。
• parameters（对象，可选）：SAP函数的参数。

工具调用示例：

{
  "function_name": "BAPI_GL_GETGLACCPERIODBALANCES",
  "parameters": {
    "COMPANYCODE": "C999",
    "GLACCT": "0010010101",
    "FISCALYEAR": "2023",
    "CURRENCYTYPE": "10"
  }
}

🔧 技术细节

工作原理

1. MCP服务器（sap_server.py）提供了一个名为call_sap_function的工具。
2. 调用时，该工具向您的SAP RESTful API发出HTTP POST请求。
3. API响应通过MCP协议返回给客户端。
4. 客户端（sap_client.py）演示如何使用此工具进行示例调用。

扩展实现

要添加更多SAP函数或修改行为：

1. 修改sap_server.py中的call_sap_tool函数。
2. 在sap_client.py中添加更多示例。
3. 根据需要更新config.json中的配置。

错误处理

实现包含基本的错误处理：

• 网络错误。
• JSON解析错误。
• 缺少函数名称。

错误以包含"error"键的JSON对象形式在响应中返回。

📚 详细文档

项目结构

附加说明

如需获取SAP动态RFC代码，请联系：zhangxj1@foxmail.com