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