MCP Sap Gui

🚀 MCP SAP GUI

MCP 是一個多語言控制平臺（Multi - language Control Platform），可用於在 SAP 系統中執行自動化任務和腳本。本項目能幫助用戶通過編寫 Python 腳本，輕鬆連接到 SAP GUI 並與之交互，提升工作效率。

🚀 快速開始

MCP 是一個多語言控制平臺（Multi - language Control Platform），用於在 SAP 系統中執行自動化任務和腳本。此文檔將引導您如何使用 MCP 連接到 SAP GUI，並通過編寫 Python 腳本來與之交互。

📦 安裝指南

安裝 MCP

1. 下載 MCP 的最新版本。
2. 解壓文件包並運行安裝程序。
3. 按照提示完成安裝過程。

配置 MCP 連接到 SAP GUI

1. 打開 MCP 的設置界面。
2. 添加一個新的“SAP GUI”連接。
3. 填寫以下信息：
   • 名稱：為您的連接起一個有意義的名字（例如：MYSAPGUI - 01）。
   • 主機名/IP 地址：輸入 SAP 服務器的地址（例如：192.168.1.100）。
   • 端口：SAP GUI 的默認端口是 32768，但您也可以使用其他自定義端口。
4. 配置完成。

💻 使用示例

基礎用法

示例：執行 MM03（物料主數據維護）

1. 打開 MCP 並選擇您的“SAP GUI”連接。
2. 在控制檯中輸入以下命令：

   mcp sap connect MYSAPGUI-01
   

3. 成功連接後，您可以執行事務代碼 MM03：

   mcp sap transaction MM03
   

示例：使用腳本批量處理

from mcp import SapGuiController

# 連接到 SAP GUI
controller = SapGuiController('MYSAPGUI-01')

# 打開事務 ME21N（採購 requisition）
controller.open_transaction('ME21N')

# 輸入物料編號
controller.input_field('Material', '12345')

# 提交事務
controller.submit()

📚 詳細文檔

項目結構和文件

目錄結構

mcp-sap-gui/
├── src/
│   └── sap_gui_server/
│       ├── __init__.py
│       ├── sap_controller.py  # SAP GUI 的交互邏輯
│       └── server.py         # MCP 服務器實現
├── tests/
│   ├── __init__.py
│   ├── test_sap_controller.py
│   └── test_server.py
├── build.bat          # 編譯和測試腳本
├── integrate.bat      # 集成腳本（用於 Cline/Roo）
├── integrate.py       # Python 腳本用於安全的 MCP 設置更新
├── requirements.txt   # 生產依賴項
└── requirements-dev.txt  # 開發依賴項

關鍵文件

• sap_controller.py：包含與 SAP GUI 交互的具體邏輯，如打開事務、輸入字段和提交。
• server.py：實現 MCP 服務器的通信協議和請求處理。
• tests/：測試套件，包括單元測試和集成測試。

開發指南

運行測試

1. 使用 MCP 檢查器運行全面測試：

   ./run.bat full
   

2. 或使用測試套件：

   • 確保 SAP GUI 已安裝並配置完成。
   • 運行測試：

     run.bat test server
     

調試和日誌

• 在開發過程中，啟用調試模式以獲取詳細的日誌信息：

  from sap_gui_server.sap_controller import SapController
  
  controller = SapController('MYSAPGUI-01', debug=True)
  

📄 許可證

[MIT License]