1つの設定済みの SAP GUI for Windows セッションのためのMCPツール。この修復はPython MCP SDK 2.1.1を使用し、公開された2026-07-28プロトコル(server/discover)と標準版でのレガシー初期化の両方に対応しています。元の7つのツール名は引き続き利用可能です。COM制御ツールやオプションのGuiXT InputScriptsは画像認識の代替手段を追加しています。

セッションをインストールして選択する

ライセンスされたSAP GUI、設定済みのSAPログオン接続、管理者がインストール・有効化したSAP GUIスクリプトを使い、インタラクティブなWindowsデスクトップ上でPython 3.11–3.13を使用します。実装は公開のSAP GUI 8.00/8.10スクリプトインターフェースを対象としています。CIはPythonとWindowsのバインディングをチェックします;実際のSAP 8.00/8.10システムはCIで実行されていません。インストール時にはSAPの現在のプラットフォーム/パッチマトリックスを参照してください。これはJava用のSAP GUIやヘッドレスSAPデスクトップをサポートしていません。

繰り返し開発を行うには、uv sync --frozen --python 3.13、uv run pytest、uv buildを使用します。build.batはローカルソースからビルドします。setup.batはパスワードのプロンプトやエコーなしにテンプレートを作成します。ノードは任意で、run.bat debug(MCPインスペクター)のみで必要です。

MCP SAP GUI

MCP tools for one configured SAP GUI for Windows session. This repair uses Python MCP SDK 2.1.1 and serves both the published 2026-07-28 protocol (server/discover) and legacy initialization over stdio. The original seven tool names remain available; COM control tools and optional GuiXT InputScripts add alternatives to image recognition.

Install and select a session

Use Python 3.11–3.13 on an interactive Windows desktop with your licensed SAP GUI, a configured SAP Logon connection, and SAP GUI Scripting installed and enabled by your administrator. The implementation targets the public SAP GUI 8.00/8.10 scripting interface. CI checks Python and Windows bindings; actual SAP 8.00/8.10 systems have not been exercised in CI. Consult SAP’s current platform/patch matrix for your installation. This does not support SAP GUI for Java or a headless SAP desktop.

python -m pip install .
Copy-Item .env.example .env
# Edit .env to select the intended session.
python -m sap_gui_server.server

For repeatable development use uv sync --frozen --python 3.13, uv run pytest, and uv build. build.bat builds from local source; setup.bat creates a template without prompting for or echoing a password. Node is optional and only needed for run.bat debug (MCP Inspector).

An existing authenticated session, including SSO, needs no password:

SAP_SESSION_ID=/app/con[0]/ses[0]
# Optional assertion, checked against the authenticated SAP user:
SAP_USER=YOUR_SAP_USER

Use the exact ID of a session reserved for automation. SAP GUI’s scripting recorder displays the connection/session indexes. The server never chooses an arbitrary active window or the first existing session. To open a new connection instead, omit SAP_SESSION_ID and set SAP_CONNECTION to its exact SAP Logon description. New connections may use existing Windows/SAP SSO; optional SAP_CLIENT, SAP_USER, SAP_PASSWORD and SAP_LANGUAGE fill the login controls through COM. Passwords are never process arguments or log entries.

SSO uses the identity of the local Windows/SAP session. It does not infer the identity of a chat user, exchange a ChatGPT token, or implement remote Microsoft on-behalf-of authentication. Run a separate local server under each intended Windows user; no shared remote authentication endpoint exists here. This distinction is part of issue #8’s remaining integration requirement.

For a custom installation set SAP_GUI_PATH to the installed saplogon.exe or its directory, for example C:\Program Files\SAP\FrontEnd\SAPGUI. This is used to start SAP Logon when its running COM object is absent. The default expects SAP Logon already running, avoiding a guessed 32-bit registry path (#3).