SAP_MCP

# SAP MCP Server and Client / SAP MCP服务器和客户端 English | [中文](#中文--english) ## English This project provides an MCP (Model Context Protocol) server and client implementation for interacting with SAP systems via a RESTful API. ### Project Structure - `config.json`: Configuration file for SAP API connection - `sap_server.py`: MCP server implementation with SAP function calling tool - `sap_client.py`: MCP client demonstrating usage of the server - `requirements.txt`: Python dependencies - `test_mcp_client_final.py`: HTTP-based MCP client test - `simple_test.py`: Simple HTTP test for the MCP server ### Installation 1. Install the required dependencies (MCP SDK version 1.3.0 or higher): ```bash pip install -r requirements.txt ``` ### Configuration Update the `config.json` file with your SAP API connection details: ```json { "sap_api": { "base_url": "http://192.168.1.129:8000/zmy_service", "client": "100", "username": "your_username", "password": "your_password" } } ``` If you don't need authentication, you can leave the `username` and `password` fields as they are or remove them entirely. ### Usage #### Running the Client To run the client example: ```bash python sap_client.py ``` This will: 1. Start the MCP server 2. Connect to it via stdio 3. Execute example SAP function calls 4. Display the results #### Running the Server in HTTP Mode To run the server in HTTP mode: ```bash python sap_server.py --transport http --host 127.0.0.1 --port 8000 ``` #### Testing with HTTP Client To test with the HTTP client: ```bash python simple_test.py ``` ### Using the MCP Tool Directly The MCP server provides a `call_sap_function` tool with the following parameters: - `function_name` (string, required): Name of the SAP function to call - `parameters` (object, optional): Parameters for the SAP function Example tool call: ```json { "function_name": "BAPI_GL_GETGLACCPERIODBALANCES", "parameters": { "COMPANYCODE": "C999", "GLACCT": "0010010101", "FISCALYEAR": "2023", "CURRENCYTYPE": "10" } } ``` ### How It Works 1. The MCP server (`sap_server.py`) provides a tool called `call_sap_function` 2. When called, this tool makes an HTTP POST request to your SAP RESTful API 3. The API response is returned through the MCP protocol to the client 4. The client (`sap_client.py`) demonstrates how to use this tool with example calls ### Extending the Implementation To add more SAP functions or modify the behavior: 1. Modify the `call_sap_tool` function in `sap_server.py` 2. Add additional examples in `sap_client.py` 3. Update the configuration in `config.json` as needed ### Error Handling The implementation includes basic error handling for: - Network errors - JSON parsing errors - Missing function names Errors are returned in the response as JSON objects with an "error" key. ### Additional Notes For SAP dynamic RFC code, please contact: zhangxj1@foxmail.com --- ## 中文 本项目提供了一个通过RESTful API与SAP系统交互的MCP（Model Context Protocol）服务器和客户端实现。 ### 项目结构 - `config.json`：SAP API连接的配置文件 - `sap_server.py`：MCP服务器实现，包含SAP函数调用工具 - `sap_client.py`：演示服务器使用方法的MCP客户端 - `requirements.txt`：Python依赖项 - `test_mcp_client_final.py`：基于HTTP的MCP客户端测试 - `simple_test.py`：用于MCP服务器的简单HTTP测试 ### 安装 1. 安装所需的依赖项（MCP SDK版本1.3.0或更高）： ```bash pip install -r requirements.txt ``` ### 配置 更新`config.json`文件中的SAP API连接详情： ```json { "sap_api": { "base_url": "http://192.168.1.129:8000/zmy_service", "client": "100", "username": "your_username", "password": "your_password" } } ``` 如果不需要身份验证，可以保留`username`和`password`字段不变或完全删除它们。 ### 使用方法 #### 运行客户端 运行客户端示例： ```bash python sap_client.py ``` 这将： 1. 启动MCP服务器 2. 通过stdio连接到服务器 3. 执行示例SAP函数调用 4. 显示结果 #### 以HTTP模式运行服务器 以HTTP模式运行服务器： ```bash python sap_server.py --transport http --host 127.0.0.1 --port 8000 ``` #### 使用HTTP客户端测试 使用HTTP客户端进行测试： ```bash python simple_test.py ``` ### 直接使用MCP工具 MCP服务器提供了一个名为`call_sap_function`的工具，具有以下参数： - `function_name`（字符串，必需）：要调用的SAP函数名称 - `parameters`（对象，可选）：SAP函数的参数 工具调用示例： ```json { "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