Sap MCP

🚀 SAP MCPサーバーとクライアント

このプロジェクトは、RESTful APIを介してSAPシステムとやり取りするためのMCP（Model Context Protocol）サーバーとクライアントの実装を提供します。

🚀 クイックスタート

このセクションでは、本プロジェクトの基本的な使い方を説明します。まずはインストールと設定を行い、その後にクライアントとサーバーの実行方法を紹介します。

✨ 主な機能

• RESTful APIを介してSAPシステムとのやり取りを可能にするMCPサーバーとクライアントを提供します。
• 基本的なエラーハンドリングを実装し、ネットワークエラーやJSON解析エラー、関数名の欠落などに対応します。
• 容易に拡張可能で、新しいSAP関数の追加や動作の変更が簡単に行えます。

📦 インストール

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