SAP MCP Server and Client / SAP MCP服务器和客户端

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):

   pip install -r requirements.txt
   

Configuration

Update the config.json file with your SAP API connection details:

{
  "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:

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:

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

Testing with HTTP Client

To test with the HTTP client:

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:

{
  "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或更高）：

   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工具

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