Skip to main content
Glama

main License sap-abap-mcp MCP server M8ven Score Listed on mcpservers.org

SAP ABAP MCP Server(ADT と JSON-RPC)

AI エージェントに SAP ABAP システムへの完全な読み書きアクセスを提供する MCP サーバーです。アクセスには ADT(ABAP Development Tools)を使用して SPNEGO/Kerberosシングルサインオン、X.509クライアント証明書、または OAuth 2.0ベーントークンで認証します。構成ファイルにパスワードは一切含まれません。ユーザー名とパスワードはフォールバックとして引き続き利用できますが、推奨されません。

これは ADT にはできない機能をひとつ追加したabap-adt-apiのラッパーです。有効なRFC関数モジュールの呼び出し を、SAP Gateway の JSON-RPC 2.0 サービス経由で行います。

128ツール — オブジェクトの CRUD、ソース編集、ロック、トランスポート、アクティベーション、構文チェック、コード補完、ABAP Unit、ATC、DDIC、abapGit、リファクタリング、トレース、デバッガ、RFC 呼び出し。

クライアン don実際に表示される数は、さらにもう一段小さくなります。プロファイル(ABAP_MCP_PROFILE)はサーフェスをコンテキストと交換します。core は 9 個のツールを、all は 129 個のツールを列挙します。これは、ツールスキーマをオンデマンドで取得できないクライアントにとっては、毎ターン約 2,700 トークンに対して約 17,800 トークンになります。また、サーバーは何かを一覧表示する前にサポート内容をシステムに問い合わせます。そのため、abapGit プラグインのないリペースでは、400 を返すような 10 個のツールが提示されることはありません。DEV では 116 個になります。

これは mario-andreschak による mcp-abap-abab-adt-api の SSO フォークです。主な違いは、Basic Auth の代わりに Kerberos SSO、JSON-RPC/RFCツール、ツール定義から生成されたルー 、そしてドキュメント化されたツールリファレンスです。


ドキュメント

ドキュメント

内容

AGENTS.md

このリポジトリについての作業方法: レイアウト、規約、テスト方法。コードを変更する前に読んでください。

docs/Tool-Router.md

やりたいこと → それを行うツール。 手書きで、人々が使う言葉で書かれています。目的はあるがツールが分からない場合に、ここから始めます。

docs/Tool-Reference.md

全 128 ツールを、その引数とともに、ファミリーごとにグループ化しています。ツール定義から生成されるため、コードから乖離しません。

docs/MCP-Tools.md

サーバーの動作。 プロファイル、ゴールデンパスのワークフロー、ADT URI とロックのセマンティクス、レスポンス/エラーモデル、トラブルシューティングマトリクス。人間と、サーバーを駆動するエージェントのために書かれています。

docs/ABAP-Skills.md

20 のSAP/ABAPスキル。それらがこれらのツールにどうマッピングされるか。

docs/Development-Skills.md

バンドルされた 35 の一般的なエンジニアリングスキル。

docs/JSON-RPC.md

JSON-RPC / RFC ツールの設計とプロトコルに関するメモ。/IWBEP/CL_JSRPC_* の ABAP ソースから読み取れます: ワイヤプロトコル、バッチの背後にある LUW の保証、そして落とし穴。

docs/Authentication.md

パスワードなしの ログオンできる 2 つのモード: Kerberos SSO、およびサービスユーザーとテクニカルユーザーのための証明書の X.509。SAP に必要な設定は、これが SNC ではなく相互 TLS である理由。


Related MCP server: ABAP-ADT-API MCP-Server

機能

  • パスワードなしの 2つのログオンモード — ログオン中の Windows ユーザーのチケットで SPNEGO/Kerberos、または Kerberos アイデンティティを持たないサービスまたはテクニカルユーザー用の X.509 証明書。どちらの方法でも SAP パスワードの保存や送信は一切行われず、セッションの有効期限が切れても両方とも自己回復します。

  • 1コンテナを共有するチームのためのストリーミング HTTP の送信 — ABAP_MCP_TRANSPORT=http を設定すると、接続する各 MCP handle 毎に自身の SAP OAuth 2.0 ベアラートークンで認証するため、全員が1つのテクニカルユーザーを共有するのではなく、セッション毎に固有の SAP ログオンが与えられます。単一のローカル起動するクライアントの場合、stdio がデフォルトのままです。[§12](docs/Authentication.md#12-streamable-http-transport-and-per-connection-sessionsは、およびこの下の Running over HTTP を参照。

  • オブジェクトを名前で読み取る — readAbapObject は名前を最初の一呼び出しでソースに解決します。ADT の URL を検出したり手作りしたりする必要ありません。

  • テーブルを記述する — describeAbapTable はフィールド、DDIC型、キーフラグ、チェックテーブルを返します。

  • オブジェクト管理 — ABAP オブジェクトの検索、読み取り、作成、変更、削除、アクティベーション。

  • 命名規約の調査 — searchPackages はパターン(re["ZPP_*","Z_PP*"])でパッケージを見つけて、各パッケージをタイプ別にグループ化したオブジェクトに1回の呼び出しで展開します。

  • ソースワークフロー — ロック → 編集 → 構文チェック → アクティベーション → ロック解除、トランスポート処理付き。

  • コードインテリジェンス — 補完、定義、使用箇所参照、ABAP Docs、プリティプリンタ、ATC、ABAP Unit、リファクタリング(名前変更、メソッド抽出)。

  • を呼ぶ RFC 関数モジュール — callFunctionViaJsonRpc を実行すると、RFC で有効な関数モジュールを実行し、そのリクエストをシステムから読み込んだ実際のシグネチャに対して検証します。

  • 1 つの LUW 内で RFC のバッチ呼び出し — callFunctionsViaJsonRpc は複数の関数モジュールを単一のリクエストで送信します。これにより、更新 BAPI とそのBAPI_TRANSACTION_COMMITが同じ LUW を共有できます。

  • データアクセス — tableContents とアドホックな runQuery SELECTs。

  • 実行中のシステムを確認 — listLoggedOnUsersは TH_USER_LIST から"誰がログオンしているか"を返し、SM04の基になるデータを取得します。readProfileParameters は RZ11 の値を1往復で読み取ります。checkLogonConfiguration は、システムが実際に受け入れている認証方式を示します。

  • 同包のエージェントスキル — skills/ 以下では ABAP(Clean ABAP、RAP、CDS、ATC、abapGit など)と一般的なエンジニアリング(TDD、コードレビュー、起因の診断)の 54 のスキルを、リソースとしてまた readSkill を通じて提供します。

  • 自己文書化 — 次のガイドは、MCP リソース(abap-adt://guides/…)と readServerGuide ツールをとして、サーバー自身が提供します。エージェントは、セッションから離れることなくタスクの途中でワークフローや引数を調べることができます。

前提条件

  • ADT が到達できる SAP ジシステム。 SICF にて /sap/bc/adt が有効である必要がある。RFC のツールでは /sap/gw/jsonrpc も有効になっている必要(SAP_GWFND)です。あなたのユーザーには、呼び出す関数グループの S_RFC が必要です。

  • パスワードなしでのログイン方法、次のいずれか:

    • Kerberos の無効なログイン — SAP システムが SPNEGO を受け入れる必要があり、有効なチケット(klist)を持っている必要があります。これはデフォルトではのWindowsが必要です: ブートストラップが C:\Windows\System32\curl.exe --negotiate を SSPI がないもの、これは curl の SSPI バックエンドが必要です。他のプラットフォームでに SSO_CURL_PATH を GSS-API 対応の curl に設定してください。 こちらの場合は。

    • X.509 クライアント証明書 — Kerberos アイデンティティを持たない /サービス/テクニカルユーザー向けです。curl も Windows も必要ありません。SAP 側の設定が必要です: ICM ポートが証明書を要求すること(icm/server_port_<n> 内 VCLIENT がicm/HTTPS/verify_client をオーバーライド)、STRUST で発行 CA の信頼、CERTRULE によるユーザーのマッピングなど。その詳細(サーバーからの確認方法も)は docs/Authentication.md を参照してください。

    • OAuth 2.0 Internet client — Kerberos レルムがなくICM が設定されていない SAP BTP ABAP 環境や、SOAUTH2 の ADT を公開する従来の宅内環境向けです。BTP のサービスキーはこの一つの例です。§11 を参照してください。

  • Node.js (LTS) と npm — node -v と npm -v で確認します。

インストール

git clone --recurse-submodules https://github.com/Ciltress/sap-abap-mcp.git
cd sap-abap-mcp
npm install
npm run build

--recurse-submodules 重要です。 一般的なエンジニアリングスのスキルはサブモジュールに含まれ、これを指定しない場合、そのディレクトリは空でサーバーが提供するスキルは 35 少なくなります。すでにクローンをお済みですか? 実行 git submodule update --init --recursive。

npm の npx mcp-abap-abap-adt-api パッケージは Upstream のサーバーであり、SSO ブートストラップや RFC ツールは含まれません。このリポジトリはソースからビルドします。

設定

.env.example を .env にコピーして、システムを入力してください:

SAP_URL=https://your-sap-server.example.com:44301
SAP_USER=YOUR_SAP_USER
SAP_CLIENT=100
SAP_LANGUAGE=EN

SAP_URL と SAP_USER は必須です。SAP_CLIENT と SAP_LANGUAGE はオプションですが推奨されます。4 つのログオンモードのうち 3 つは、SAP_PASSWORD を必要としません。

.env をコミットしないでください。すでに .gitignore に含まれています。

Optional variable

Effect

SAP_SYSTEM_ID

システムID(sy-sysid の値、例: DEV)。接続時に通知されるため、クライアントは名前で複数のサーバーから選択できます。複数のシステム を参照してください。

NODE_TLS_REJECT_UNAUTHORIZED=0

内部/不明の CA から発行された証明書を受け入れます。開発専用。

SSO_CURL_PATH

Windows 標準のものではない、SPNEGO サポート付き curl バイナリへのパス。

SAP_JSONRPC_PATH

ノードがエイリアスで公開されている場合、JSON-RPC ICF パスを上書きします。

ABAP_MCP_PROFILE

このサーバーが一覧表示するツール、つまり応答するツールを指定します。後述参照。

ABAP_MCP_MAX_RESPONSE_BYTES

単一の応答の上限(バイト単位)。0 で上限なし。

ABAP_MCP_GATE

off にすると、このリリースでは提供できないツールを除外する起動時ケイパビリティチェックをスキップします。

ABAP_MCP_RFC_FALLBACK

SAP がこのユーザーに ADT ノードを拒否しても、RFC ツールを維持したまま起動します。docs/Authentication.md を参照してください。

SAP_FALLBACK_BOOTSTRAP_PATH

フォールバックがログオンする ICF ノード。セッションクッキーと CSRF トークンを発行するだけで十分です。

ABAP_MCP_TRANSPORT

stdio(デフォルト)または http。HTTP 経由での実行 を参照してください。

ABAP_MCP_HTTP_PORT

Streamable HTTP エンドポイントのポート。デフォルト 3000。http モードでのみ読み取られます。

ABAP_MCP_HTTP_HOST

http モードでバインドするアドレス。デフォルト 0.0.0.0。

ABAP_MCP_HTTP_ALLOWED_ORIGINS

/mcp を呼び出せるブラウザオリジン(カンマ区切り)。* はすべて許可します。空(デフォルト)は不可。Origin を送信しないクライアントには影響しません。

ABAP_MCP_HTTP_ALLOWED_HOSTS

http モードでこのサーバーが応答する Host 値(カンマ区切り)。空はすべて受け付けます。

ABAP_MCP_HTTP_RATE_LIMIT

http モードでの MCP セッションごとの毎分リクエスト数。0(デフォルト)はオフ。

クライアントに合わせたサーバーのサイジング

ABAP_MCP_* という 3 つの変数が存在する理由は 1 つだけです。ツールスキーマをオンデマンドで取得できないクライアントは、毎回のターンでツールリスト全体のコストを支払うことになるからです。Claude Code はスキーマを遅延取得するため、デフォルトのままにするべきです。128k ウィンドウの 8B モデルは、会話が始まる前にコンテキストの 6 分の 1 を消費しており、"同じプロンプトしか半分しか機能しない"という状態はここから生まれます。

ABAP_MCP_PROFILE — 未設定は all を意味するため、既存のセットアップは変更されません。

profile

tools/list

ターンあたりのコスト

対象

core

9

~2,737 tokens

システムの読み取りと編集を 1 つ完了する

analyst

18

~3,982 tokens

読み取り専用: ディクショナリ、テーブルデータ、RFC 呼び出し

rfc

10

~2,900 tokens

RFC 権限を持つが S_DEVELOP がなく、ADT ツールが使用できないユーザー

dev

49

~8,034 tokens

編集サイクルに加え、テスト、ATC、トランスポート、リファクタリング

all

129

~17,759 tokens

デフォルト。スキーマをオンデマンドで取得するクライアントに最適

カウントには healthcheck も含まれます。healthcheck は「どのプロファイルで実行しているか?」という問いに答えるツールなので、すべてのプロファイルの外側に位置します。

プロファイルは便利なフィルターではありません。アクティブなプロファイル外のツールは一覧に表示されず、ルーティングもされないため、呼び出すことはできません。そのため analyst は単なるメニューが小さいというだけでなく、ソースを編集するものが一切ないことを保証します。プロファイル外のツールを呼び出すと、"unknown tool" ではなくその旨のエラーが返されるため、リトライしても意味はありません。不適切なプロファイル名は all へフォールバックせず、起動時にサーバーを停止します。9 個を要求したプロファイルに対して 129 個のツールを黙って提供するのは、まさにプロファイルが防ぐべき失敗です。

core が小さい理由は、editAbapSource という 1 つのツールが書き込みサイクル全体(ロック、書き込み、有効化、ロック解除。ステップが失敗してもロックを解放する)を担っているからです。個別の 4 ステップは dev と all に残ります。

ABAP_MCP_MAX_RESPONSE_BYTES — ツールリストはプロファイルが縮小できる固定コストですが、応答は上限がありません。core ではツールリスト全体が約11KB である一方、adtDiscovery は約42KBです。未設定はプロファイルに従います (core 24,000バイト、analyst 32,000、dev 48,000、all は上限なし) 。 0 で制限を解除します。

予算超過の応答は保留され、有効な JSON に置き換えられます — status:"truncated"、元の bytes、budget、2,000バイトの preview、そして nextStep — カットされた断片は決して返されません。それはサースできず、同じリトライを促すだけです。

ABAP_MCP_GATE — ツールを一覧する前に、サーバーはシステムが何をサポートしているかを問い合わせ、ADT コレクションが存在しないツールを除外します。DEV では、abapGit ツール 10 個とサービスバインディングツール 3 個が該当し、これらは本来 HTTP 400 を返します。この処理はプロセスごとに 1 回のディスカバリ往復コストがかかりますが、リストを短くすることしかできず、失敗してもすべてのツールを一覧表示に残します。ABAP_MCP_GATE=off でスキップできます。

healthcheck は、アクティブなプロファイル、responseBudgetBytes、および何が除外されたかをすべて報告します。

Kerberos の代わりに証明書

サービスユーザーや技術ユーザーの場合は、証明書を追加します — それだけでモードが変わります:

SAP_USER=CLAUDEAGENT                                 # the user CERTRULE maps the certificate to
SAP_CERT_FILE=C:\Users\svc_agent\SNC\sec\claudeagent.p12
SAP_CERT_PASSPHRASE=<PKCS#12 password / PSE PIN>

Optional variable

Effect

SAP_AUTH_MODE

kerberos, certificate, oauth, password。別のモードが設定されている場合にのみ特定の中のモードで強制します。

SAP_CERT_KEY_FILE

SAP_CERT_FILE に秘密鍵がない場合の秘密鍵。

SAP_CA_FILE

TLS 検証を無効にする代わりに、SAP 自身の証明書を検証するための CA バンドル。

これは相互 TLS であり、SNC ではありません — ADT は HTTPS です。RFC/SNC で既に機能している証明書は再利用でき、その CERTRULE マッピングも引き継がれますが、SNC0 ACL は関係しませんし、ICM は icm/HTTPS/verify_client を必要とします。相違点、sapgenpse export_p12 / OpenSSL 3 の落とし穴、拒否された証明書の読み方については、docs/Authentication.md を参照してください。

BTP と SOAUTH2 のための OAuth 2.0 クライアント

SAP BTP ABAP 環境や、認可サーバーの背後で ADT を公開するオンプレミスシステム用です。クライアント ID を設定するだけでモードが切り替わります:

SAP_OAUTH_TOKEN_URL=https://your-tenant.authentication.eu10.hana.ondemand.com/oauth/token
SAP_OAUTH_CLIENT_ID=sb-abap-agent!t1234              # 'clientid' in a BTP service key
SAP_OAUTH_CLIENT_SECRET=<'clientsecret'>

オンプレミスでは、エンドポイントは SAP ホスト自体にあります — https://<host>:<port>/sap/bc/sec/oauth2/token — そしてクライアントは SOAUTH2 に登録されたものです。

Optional variable

Effect

SAP_OAUTH_GRANT

client_credentials(デフォルト)、refresh_token、password、static。

SAP_OAUTH_SCOPE

要求するスコープ。未設定はクライアントのデフォルトを要求します。通常はそれが正しい。

SAP_OAUTH_REFRESH_TOKEN

refresh_token グラントに使用。設定するだけでそのグラントが選ばれます。

SAP_OAUTH_TOKEN

別の場所で発行されたトークンをそのまま使用します。更新することはできません。

SAP_OAUTH_CLIENT_AUTH

basic(デフォルト)または post。サーバーが正しい秘密鍵を拒否した場合に使用します。

トークンは一度だけログインします。 その後は SAP セッションクッキーがすべてのリクエストを運ぶため、他のモードと同じであり、5分で失効するトークンでも問題ありません。AS ABAP では OAuth 2.0 クライアントは SU01 上のユーザーであることに注意してください。間違 った SAP_OAUTH_CLIENT_SECRET は、パスワードと同様に login/fails_to_user_lock にカウントされるため、拒否されたトークン要求は再試行されません。認可コードフローは実装されていません — ブラウザが必要であり、stdio で動くサーバーには開く方法がありません。一度手で完遂し、リフレッシュトークンを渡してください。詳細は docs/Authentication.md §11 を参照してください。この中には、どの失敗がラッチされ、なぜそのような失敗がラッチされるかも含まれます。

他に何もない場合のパスワード

Kerberos も証明書もないシステム — サンドボックス、トライアル、ドメイン外のあらゆるもの — の場合:

SAP_USER=CLAUDEAGENT
SAP_PASSWORD=<the password>

最後の手段であり、他の 2 つとは代替できません。 チケットがない、またはマッピングされていないだけで単純に拒否されます。しかし 間違ったパスワード は login/fails_to_user_lock に指摘され、このサーバーだけではなく、そのユーザーのすべての利用者に対してロックされます。そのため、この実装は拒否されたパスワードの再試行をしません — ログイン失敗一回、ラッチ。振る舞いはクロ数に関わらず。自動運用には 証明書を優先してください。 docs/Authentication.md §10 に詳細があります。

MCP クライアントに登録する

ビルドされたエントリポイントを絶対パスでクライアントに指定します:

{
  "mcpServers": {
    "sap-abap-dev-100": {
      "command": "node",
      "args": ["C:/path/to/sap-abap-mcp/dist/index.js"],
      "env": {
        "SAP_URL": "https://your-sap-server.example.com:44301",
        "SAP_USER": "YOUR_SAP_USER",
        "SAP_SYSTEM_ID": "DEV",
        "SAP_CLIENT": "100",
        "SAP_LANGUAGE": "EN"
      }
    }
  }
}

クライアントの env ブロックは .env より優先されます。手動でサーバーを起動するには npm run start を、MCP Inspector で操作したい場合は npm run dev を使用します。

毎回すべてのツールスキーマを持つクライアントの場合は、その同じブロックにプロファイルを追加してください:

"env": { "…": "…", "ABAP_MCP_PROFILE": "core" }

Docker の場合

デフォルトではサーバーは stdio で MCP を話すため、公開するポートはありません — クライアントがコンテナを起動し、stdin/stdout で通信します。このセクションではそのデフォルトを取り上げます。チームの複数のメンバーがネットワーク経由で接続するコンテナの場合は、下記の HTTP 5 を参照してください。

docker build -t abap-adt-mcp .
{
  "mcpServers": {
    "sap-abap-dev-100": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--env-file",
        "C:/path/to/.env",
        "abap-adt-mcp"
      ]
    }
  }
}

4 つのログオンモードすべて、ここで動作します が、資格情報はコンテナに与えるが必要で、--env-file はデトエン的にありません — Docker はクォートを取り除かず、export を読み取らず、末尾の # comment も削除しないため、dotenv なら綺麗に取り除いていた価値がそのまま届きます。.env 内の Windows パスは、マウントされたパスに置き換えなければなりません。Kerberos はコンテナに最も多くのものを要求するモードであり、OAuth は最も少ないものです。トークンはネットワーク経由で取得されるので、マウントするものは何もありません。

証明書モード — 鍵マテリアルを読み取り専用でマカウントし、さらにSAP の証明書に署名している CA もマウントします:

docker run -i --rm --env-file .env \
  -v /host/certs:/certs:ro \
  -e SAP_CERT_FILE=/certs/agent.p12 \
  -e SAP_CA_FILE=/certs/corporate-root.pem \
  abap-adt-mcp

Kerberos モード — イメージには GSS-API と kinit に対してビルドされた curl が含まれているので、残るのはレルムと資格情報だけです:

docker run -i --rm --env-file .env \
  -v /etc/krb5.conf:/etc/krb5.conf:ro \
  -v /host/agent.keytab:/krb5/agent.keytab:ro \
  -e SAP_KRB_KEYTAB=/krb5/agent.keytab \
  -e SAP_KRB_PRINCIPAL=SVC_AGENT@CORP.EXAMPLE.COM \
  abap-adt-mcp

OAuth 2.0 モード — マウントするものはありません。資格情報は取得されます:

docker run -i --rm --env-file .env \
  -e SAP_OAUTH_TOKEN_URL=https://your-tenant.authentication.eu10.hana.ondemand.com/oauth/token \
  -e SAP_OAUTH_CLIENT_ID='sb-abap-agent!t1234' \
  -e SAP_OAUTH_CLIENT_SECRET=<clientsecret> \
  abap-adt-mcp

Password モード — 最後の手段です!

docker run -i --rm --env-file .env \
  -e SAP_USER=YourUser \
  -e SAP_PASSWORD=YourPassword \
  abap-adt-mcp

それを使う前に知っておくべきことが3つあります:

  • keytab であって、自分自身のチケットではない。 コンテナーは、対話式ログオンが行うようにセッションの資格情報を借用することはできません。Linux ホストでは、既に持っているチケットキャッシュをマウントできます()-v /tmp/krb5cc_1000:/krb5/ccache:ro -e KRB5CCNAME=FILE:/krb5/ccache`)が、その有効期限はホスト側のものと同時に切れます。Windows ホストからはどちらも機能しません: TGT は LSA キャッシュ内にあり、ファイルに書き出すことができないため、これらが不要な証明書モードを使っください。keytab は、無人で実行できる唯一の資格情報であり、チケットの有効期間を超えて存続する唯一の資格情報です。

  • SAP の証明書を検証するか、検証していないことを自覚する。 イメージは公開 CA バンドルのみを信頼するため、ホストが信頼する内部 CA はここでは不明であり、ハンドシェイクは UNABLE_TO_GET_ISSUER_CERT_LOCALLY で失敗します。ルート CA をマウントし、SAP_CA_FILE をその CA に向けます。デスクトップの .env を丸ごと持ち込むと、この問題を隠してしまいます。NODE_TLS_REJECT_UNAUTHORIZED=0 は開発用の設定であり、デプロイされたイメージに導入されるべきではありません。

  • --recurse-submodules を付けたクローンからビルドする。 skills/Development はサブモジュールです。これがないと、イメージに同梱されるスキルが35個少なくなります。

イメージが Alpine ではなく Debian であるのは、理由が1つだけです: Alpine の curl は GSS-API なしでビルドされており、そのような curl は失敗するということはありません。ただ単にトークンを送信ただそれだけで、SAP は期限切れチケットと同じ 401 を返します。不足しているものは、セッションが試行される前に、起動時に stderr で示されます。コンテナが最終的にどの資格情報で動作したかを確認するには、サーバーの代わりにコマンドを指定します:

docker run --rm --env-file .env -v /host/agent.keytab:/krb5/agent.keytab:ro \
  -e SAP_KRB_KEYTAB=/krb5/agent.keytab abap-adt-mcp klist

docs/、skills/、AGENTS.md は意図的にイメージ内にコピーされます。サーバーは実行時にこれらを読み取って、readServerGuide、readSkill、および abap-adt:// リソースを提供するからです。コンテナの完全なセットアップ方法は、docs/Authentication.md §7 にモードごとに記載されています。

HTTP で実行する

上記のすべては、stdio 上で1つのクライアントに対して、1つのサーバーを起動します。代わりに ABAP_MCP_TRANSPORT=http を設定すると、チーム全体がネットワーク経由で接続する長期間稼働するコンテナを実行でき、SDK の Streamable HTTP トランスポートを /mcp で使用します。

HTTP モードは、誰がログオンするかを変更するものであり、ログオン後にセッションで何ができるかは変更しません。上記の4つのモード — SAP_AUTH_MODE、SAP_CERT_FILE、SAP_OAUTH_CLIENT_ID、SAP_PASSWORD — はどれもここには適用されません。設定すべき共有されたログオンが存在しないからです。代わりに、すべての MCP クライアントは、自身の SAP OAuth 2.0 ベアラートークンで認証しなければなりません。initialize の際に Authorization: Bearer <token> を送信し、そのトークンがそのセッション自身の SAP アイデンティティ — 独自の ADT ログオン、独自のロック、独自の監査記録 — になります。同時に2人のチームメンバーが接続した場合、共有された技術ユーザーではなく、独立した2つのセッションが得られます。

docker build -t abap-adt-mcp .
docker run --rm -p 3000:3000 \
  -e SAP_URL=https://your-sap-server.example.com:44301 \
  -e SAP_USER=CLAUDEAGENT \
  -e SAP_CLIENT=100 \
  -e ABAP_MCP_TRANSPORT=http \
  abap-adt-mcp

SAP_USER は引き続き必要ですが(パスワード以外のモードでは ADT クライアントを構築するためのプレースホルダーユーザー名が必要)、送信されることはなく、特定のセッションの実際の識別には影響しません。SAP は各セッションの独自のトークンからそれを決定します。§11 と同じです。

変数

効果

ABAP_MCP_TRANSPORT=http

stdio から Streamable HTTP に切り替える。

ABAP_MCP_HTTP_PORT

待受ポート。デフォルト 3000。

ABAP_MCP_HTTP_HOST

バインド先のアドレス。デフォルト 0.0.0.0。

ABAP_MCP_HTTP_ALLOWED_ORIGINS

/mcp を呼び出せるブラウザオリジン。カンマ区切り。* はすべてを許可。空(デフォルト)は許可しない。

ABAP_MCP_HTTP_ALLOWED_HOSTS

応答する Host 値。カンマ区切り。空は任意のホストを許可。

ABAP_MCP_HTTP_RATE_LIMIT

セッションごとの1分あたりのリクエスト数。0(デフォルト)は無効。

他のリモート Streamable HTTP MCP サーバーと同様に、/mcp を指し、そのユーザー自身の SAP OAuth トークンを指定してクライアントを登録します:

{
  "mcpServers": {
    "sap-abap-dev-100": {
      "url": "http://your-host:3000/mcp",
      "headers": { "Authorization": "Bearer <your SAP OAuth access token>" }
    }
  }
}

資格情報がないリクエストは、SAP への通信前に 401 で拒否されます。SAP 自体が拒否するトークンも、SAP 自身のメッセージとともに 401 になります。トランスポート自体に設定すべき別の共有シークレットはありません。SAP のトークンこそアクセス制御です。

アクセストークンの期限で毎回切断されたくないクライアントは、独自の認証トークンを X-SAP-Refresh-Token として送信することができます。その場合、セッションは refresh_token グラントで自動的に更新されます。これにはコンテナ内に SAP_OAUTH_TOKEN_URL と SAP_OAUTH_CLIENT_ID が必要です。リフレッシュトークンが妥当するクライアント登録は導入側のもので、リフレッシュトークン、ひいては SAP のアイデンティティは呼び出し側のものにります。

ブラウザオリジンは、ABAP_MCP_HTTP_ALLOWED_ORIGINS で指定しない限り拒否されます。これは、MCP 仕様がサーバー自身で適用するよう求めている DNS リバインディング対策であり、リバインディングリクエストは前段のプロキシを通過しないことがあるからです。許可リストに含まれるかどうか、一致する CORS ヘッダーが返されます。Origin を送信しないクライアント(Web ページではないすべての MCP クライアント)は、影響を受けません。

コンテナの docker-entrypoint.sh は、ABAP_MCP_TRANSPORT=http が設定されていると、Kerberos のセットアップを自動的にスキップします。**クライアントがそれぞれ自身のトークンでログオンするため、resolveAuthMode() の選択は現実の何も表していないからです。TLS 終端は、他の内部 HTTP サービスと同様、コンテナの前段側にあるもの(リバースプロキシやイングレス)に委ねられます。これが、シンプル化された OAuth グラントの仕組みまで含めた全容は、docs/Authentication.md の§12 にあります。

複数システム

サーバーは、その生涯を通じて1つのシステムと1つのクライアントにバインドされています。どちらも実行時に切り替えることはできません。そのため、システム/クライアントごとに1つのエントリを登録し、各エントリに SAP_SYSTEM_ID を指定します:

"sap-abap-dev-100": { "env": { "SAP_SYSTEM_ID": "DEV", "SAP_CLIENT": "100", "…": "…" } },
"sap-abap-dev-200": { "env": { "SAP_SYSTEM_ID": "DEV", "SAP_CLIENT": "200", "…": "…" } },
"sap-abap-q01-100": { "env": { "SAP_SYSTEM_ID": "Q01", "SAP_CLIENT": "100", "…": "…" } }

各サーバーは、接続時に返す MCP の instructions の中で自分自身を宣言:

このサーバーは SAP システム DEV のクライアント 100 (https\://…:44301) にバインドされています。 実行時にシステムやクライアントを切り替えることはできません。両方とも起動された環境によって固定されています。リクエストが別のシステムまたはクライアントを指定している場合は、そのための MCP サーバーを使用添加さい。登録されていない場合は、ここで動作するのではなく、そうである旨を伝えてください。

これによって、エージェントは「これを DEV のクライアント 200 で確認して」というリクエストを、何かを呼び出ことなく適切なサーバーへルーティングできます。直接問い合わせが必要なサーバーには、healthcheck が同じアイデンティティを報告します。

この宣言がチェックされます。 SAP はログイン時に設定するセッション cookie(SAP_SESSIONID_DEV_100)内でシステムとクライアントを指定するため、サーバーは実際に何に接続されているかを認識します。これが SAP_SYSTEM_ID と一致しない場合(たとえばコピーペーストしたエントリが誤ったホストを指している場合)は、healthcheck が WARNING を伝え、起動時に大声にログ出力されます。監視する価値があります。すべてのツールは正常に動作し続けるからです。ただし、それが正しいシステムのように動いているだけです。


クイックツアー

名前を指定すれば、イメージの URL ディスカバリなしにオブジェクトを読み取れます:

{"tool":"readAbapObject","args":{"objectName":"ZCL_MY_CLASS"}}
{"tool":"describeAbapTable","args":{"tableName":"T000"}}

名前規約全体を俯瞰する場合 — パターンは自動的に正規化されるので、zpp_lab は ZPP_LAB* になります:

{ "tool": "searchPackages", "args": { "patterns": ["ZPP_*", "Z_PP*"] } }
// -> each package with its objects grouped by type, sub-packages, and a `truncated` flag

関数モジュールを呼び出す場合 — シグネチャが最初に式され、それにに対してリクエストが検証されます:

{"tool":"readAbapFunctionModule","args":{"functionModuleName":"STFC_CONNECTION"}}
{"tool":"callFunctionViaJsonRpc","args":{"functionModuleName":"STFC_CONNECTION",
                                         "inputParameters":{"REQUTEXT":"hello"}}}

BAPI とそのコミットは 1つ のバッチでは、コミットします。そうしない場合、コミットは自身の LUW に乗り、BAPI の変更は失笑します:

{
  "tool": "callFunctionsViaJsonRpc",
  "args": {
    "calls": [
      {
        "functionModuleName": "BAPI_USER_LOCK",
        "inputParameters": { "USERNAME": "DEVUSER" },
      },
      {
        "functionModuleName": "BAPI_TRANSACTION_COMMIT",
        "inputParameters": { "WAIT": "X" },
      },
    ],
  },
}

完全な書き込みサイクル (lock → modify → check → activate → unlock)、デバッガー、ATC、およびその他すべてのワークフローの詳細は、docs/MCP-Tools.md §4 にまとめられています。


ABAP オブジェクトを操作する

3つのツールが、必要な機能のほぼすべてを提供します。それぞれは ADT URL ではなく名前を受け取ります:

必要なもの

ツール

クラス、プログラム、インクルード、ファンクショングループ、またはモジュールのソース

readAbapObject

テーブル、構造、ビューの概要

describeAbapTable

abap の命名規則の背後にあるすべて

searchPackages

{"tool":"readAbapObject",   "args":{"objectName":"ZCL_MY_CLASS"}}
{"tool":"describeAbapTable","args":{"tableName":"T000"}}
{"tool":"searchPackages",   "args":{"patterns":["ZPP_*","Z_PP*"]}}

readAbapObject は、1回の呼び出しでメタデータとソースを返します。名前が複数のオブジェクトに属している場合 — ZPP_EXT_LABEL_DATA は関数ファンクショングループと関数モジュールの両方です — より固有のオブジェクトを選択し、どの ambiguous:true と alternatives を介して知らせます。 objectType を渡すと、選択を強制できます。ソースがないオブジェクトは hasSource:false と適切なツールのポインタを返します。

describeAbapTable は、フィールド名、DDIC 型、長さ、キー フラグ、データ要素、ドメイン、チェックテーブル を返します。チェックテーブルは外部キーの宛先であり、2つのテーブルの結合関係を確認する最も簡単な方法です。objectStructure はテーブルのフィールドを返しず、持つ tableContents は定義ではなく行を返すため、どちらも「このテーブルはどんな姿か」には答えません。

クライアントのシステムプロンプトに入れておくべきルール

  • 実行中 by-nameツールを優先します。 途中結果が必要な場合のみ searchObject → objectStructure → getObjectSource にフォールバックます。/sap/bc/adt/... パスを手で構築することは絶対にてはいけません。

  • 効率の良い SELECT を使用。 SAP のテーブルは巨大です。常に WHERE 句で SELECT を制限し、他のフィールドは SELECT SINGLE(キーフィールドがすべて分かっているとき)または UP TO n ROWS を使用してください。

SELECT vgbel FROM vbrp WHERE vbeln = @lv_vbeln INTO @DATA(lv_vgbel) UP TO 1 ROWS.
  EXIT.
ENDSELECT.

SAP とfileシステムは切り離されています: ソースを読み取ると、それはツールの結果としてのみ返ってきます。ローカル・ファイルが書かれても SAP の内容は変わります。ローカルコピーが便利なのは差分を取るときだけです。

以前の README では GetTable、GetStructure、GetTypeInfo が記載されていました。これらはこのサーバーによってなく、単独の mcp-apab-adt プロジェクトのものです。


Development

npm run build          # tsc -> dist/
npm test               # vitest: parser, tool catalogue, JSON-RPC handler (no SAP system needed)
npx tsc --noEmit       # type check only

テストは src/__tests__ にあり、完全にオフラインで実行されます。JSON-RPC スイートは、模擬 SAP Gateway ノードに対してハンドラをエンドツーエンドで検証します。

実際のシステム相手の場合(Kerberos のチケットが必要)、エンドツーエンドの確認は次のとおり:

npm run build
node scripts/live-jsonrpc-check.mjs      # add NODE_TLS_REJECT_UNAUTHORIZED=0 for an internal CA

これは、ビルド済みサーバーをクライアントが行うったときと同じように MCP stdio で駆動し、読み取り専用の関数モジュールだけを呼び出します。

ツールを追加するのは1ファイルの変更だけです — 例えば docs/MCP-Tools.md §10(docs は「エクステージ・サーバー」参照) を参照ください。

Troubleshooting

症状

原因 / 対処法

HTTP 401 が返る

Kerberos モード: 有効なチケットがない、またはシステムが SPNEGO を受け付けない — klist と VPN/ドメイン接続を確認してください。証明書モード: docs/Authentication.md §6 を参照してください。

curl nicht gefunden

SSO のブートストラップが curl を見つけられませんでした — SSO_CURL_PATH を設定してください。

SAP rejected the client certificate

原因は CERTRULE マッピング、icm/HTTPS/verify_client、または STRUST の CA トラストです。エラーには提示されたサブジェクトが表示されます — それを CERTRULE と比較してください。

unable to get local issuer certificate

内部 CA が原因です。NODE_TLS_REJECT_UNAUTHORIZED=0 を設定してください(開発時のみ)。

RFC ツールが reachable:false を返す

checkJsonRpcEndpoint を実行してください。非アクティブな /sap/gw/jsonrpc SICF ノードと、CSRF または認可の問題を切り分けられます。

ファンクションモジュールが -32601 を返す

そのモジュールが存在しない、RFC が有効でない、または S_RFC がそのファンクショングループを拒否しています。

クライアントにツールが表示されない

dist/index.js の絶対パスを確認し、npm run build が実行されていることを確認してください。

詳細は docs/MCP-Tools.md §8 を参照してください。

コントリビューション

  1. リポジトリをフォークしてください

  2. git checkout -b feature/your-feature-name

  3. 変更を加え、npm test と npx tsc --noEmit が green のままであることを確認してください

  4. git commit -m "Add some feature" を実行し、git push origin feature/your-feature-name を実行してください

  5. プルリクエストを開いてください

ライセンス

MIT。アップストリームプロジェクトおよび原作者: mario-andreschak。

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      Not graded
      maintenance
      An MCP server that facilitates seamless interaction with SAP ABAP systems to manage development objects, transport requests, and source code. It provides a comprehensive suite of tools for performing syntax checks, object searches, and code modifications via the ADT API.
      100
      -
    • A
      license
      C
      quality
      D
      maintenance
      An MCP server that enables seamless communication between ABAP systems and MCP clients using the ABAP Development Tools (ADT) API. It provides tools for managing ABAP objects, handling transport requests, and performing code analysis directly through MCP-compatible interfaces.
      100
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A standalone MCP server for SAP ABAP development and customizing that connects directly to your SAP system via ADT REST API, enabling AI assistants to search, read, write, activate, transport, debug, and run quality checks on ABAP code, as well as manage customizing/IMG configurations with governed transport recording.
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      MCP server for SAP ABAP development that enables AI assistants and code editors to interact with SAP systems via ABAP Developer Toolkit (ADT) APIs, supporting read, create, update, and delete of ABAP objects.
      100
      MIT