MCP Sap Gui Advanced

🚀 SAP MCP Server - 包括的なSAP GUI自動化

Model Context Protocol (MCP)サーバーで、Claude Desktopとの統合に向けた包括的なSAP GUI自動化機能を提供します。PythonとTypeScriptの両方で実装された22の専用SAP自動化ツールを備えています。

🚀 クイックスタート

オプション1: 自動セットアップ (推奨)

# リポジトリをクローンする
git clone https://github.com/USERNAME/mcp-sap-gui-advanced.git
cd mcp-sap-gui-advanced

# クイックセットアップスクリプトを実行する
# Windows:
quick-setup.bat

# macOS/Linux:
chmod +x quick-setup.sh
./quick-setup.sh

オプション2: 手動セットアップ

詳細な手動インストール手順については、SETUP.mdを参照してください。

🔒 プライバシーとセキュリティ

このプロジェクトは完全にローカルで動作し、個人情報を収集または送信することはありません。詳細については、PRIVACY.mdを参照してください。

プロジェクト構造

SAP MCP Server/
├── python/                 # Python実装
│   ├── direct_sap_server.py     # 22のSAP自動化ツール
│   ├── test_comprehensive.py    # 完全なテストスイート
│   └── claude_desktop_direct.json
├── typescript/             # TypeScript実装
│   ├── direct-sap-server.ts     # 22のSAP自動化ツール
│   ├── test-comprehensive.js    # 完全なテストスイート
│   └── claude-desktop-config.json
└── README.md              # このファイル

包括的なSAP自動化 (22のツール)

接続とセッション管理

• sap_connect - 資格情報を使用してSAPシステムに接続する
• sap_disconnect - SAPシステムから切断する
• sap_get_sessions - 複数のSAPセッションを管理する

ナビゲーションとトランザクション管理

• sap_navigate - トランザクション (VA01、MM01、SE80など) に移動する
• sap_navigate_back - 戻る (F3相当)
• sap_navigate_exit - トランザクションを終了する (F15相当)

フィールド操作

• sap_input_field - SAPフィールドにデータを入力する
• sap_get_field_value - フィールドの値を取得する
• sap_clear_field - フィールドの内容をクリアする

ボタンとメニュー操作

• sap_press_button - GUIボタンを押す
• sap_select_menu - メニュー機能にアクセスする

ファンクションキー操作

• sap_send_key - ファンクションキー (F1 - F24、Enter、Escape) を送信する

テーブル操作

• sap_get_table_data - テーブル/グリッドのデータを抽出する
• sap_set_table_cell - テーブルのセルを変更する
• sap_select_table_row - テーブルの行を選択する

画面情報

• sap_get_screen_info - 現在の画面の詳細を取得する
• sap_get_status_message - ステータスメッセージを読み取る

ビジュアル操作

• sap_screenshot - 画面画像をキャプチャする

高度な操作

• sap_execute_transaction - 多段階のトランザクション処理
• sap_wait_for_screen - 画面の読み込みを同期する

データ交換

• sap_export_data - CSV、Excel形式でエクスポートする
• sap_import_data - ファイルからデータをインポートする

🛠️ クイックスタート

TypeScriptバージョン

cd typescript
npm install
npm run build
npm start

Pythonバージョン

cd python
uv install
uv run python -m sap_mcp_server.main

🔧 MCPクライアント構成

両方の実装は、任意のMCPクライアントと互換性があります。

Claude Desktop (claude_desktop_config.json)

TypeScript:

{
  "mcpServers": {
    "sap-automation-ts": {
      "command": "node",
      "args": ["./typescript/build/index.js"],
      "cwd": "/path/to/sap-mcp-server"
    }
  }
}

Python:

{
  "mcpServers": {
    "sap-automation-py": {
      "command": "python",
      "args": ["-m", "sap_mcp_server.main"],
      "cwd": "/path/to/sap-mcp-server/python"
    }
  }
}

要件

共通要件

• SAP GUI がインストールされている (実際のSAP自動化に必要)
• Windows (SAP GUIスクリプトの場合は推奨)
• MCP互換クライアント (Claude Desktop、VS Codeなど)

TypeScript固有の要件

• Node.js 17+
• npm または yarn

Python固有の要件

• Python 3.10+
• uv (推奨) または pip

使用例

両方の実装は、同じ自然言語コマンドをサポートしています。

SAPに接続する

"Connect me to SAP system DEV with client 100, username john.doe, password mypass123, server sap-dev.company.com"

ナビゲートしてデータを入力する

"Navigate to transaction VA01 and create a sales order with customer 12345 and material ABC123"

データを抽出する

"Extract customer data from the current screen, specifically the name, address, and contact fields"

セキュリティと統合

両方の実装には以下が含まれています。

• SAPドライバーの統合に備えたプレースホルダー関数
• 環境変数を使用した安全な資格情報の処理
• スキーマによる入力検証
• エラー処理とロギング
• ドキュメントとサンプル

言語間の移行

MCPプロトコルは言語に依存しないため、以下のことができます。

• 一方の実装から始めて後で切り替える
• 異なるユースケースで両方を同時に実行する
• チームの専門知識に基づいて選択する
• 既存のSAP自動化コードと統合する

ドキュメント

• TypeScript README - TypeScript固有のセットアップと使用方法
• Python README - Python固有のセットアップと使用方法
• Integration Guide - SAPドライバーとの統合方法
• MCP Documentation - 公式MCPプロトコルのドキュメント

デバッグ

どちらの実装でも、MCP Inspector を使用できます。

Python:

python test_comprehensive.py

TypeScript:

node test-comprehensive.js

📄 ライセンス

[MIT License] このプロジェクトはMITライセンスの下でライセンスされています。