sap-abap-mcp
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ツール、ツール定義から生成されたルー 、そしてドキュメント化されたツールリファレンスです。
ドキュメント
ドキュメント | 内容 |
このリポジトリについての作業方法: レイアウト、規約、テスト方法。コードを変更する前に読んでください。 | |
やりたいこと → それを行うツール。 手書きで、人々が使う言葉で書かれています。目的はあるがツールが分からない場合に、ここから始めます。 | |
全 128 ツールを、その引数とともに、ファミリーごとにグループ化しています。ツール定義から生成されるため、コードから乖離しません。 | |
サーバーの動作。 プロファイル、ゴールデンパスのワークフロー、ADT URI とロックのセマンティクス、レスポンス/エラーモデル、トラブルシューティングマトリクス。人間と、サーバーを駆動するエージェントのために書かれています。 | |
20 のSAP/ABAPスキル。それらがこれらのツールにどうマッピングされるか。 | |
バンドルされた 35 の一般的なエンジニアリングスキル。 | |
JSON-RPC / RFC ツールの設計とプロトコルに関するメモ。 | |
パスワードなしの ログオンできる 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とアドホックなrunQuerySELECTs。実行中のシステムを確認 —
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=ENSAP_URL と SAP_USER は必須です。SAP_CLIENT と SAP_LANGUAGE はオプションですが推奨されます。4 つのログオンモードのうち 3 つは、SAP_PASSWORD を必要としません。
.env をコミットしないでください。すでに .gitignore に含まれています。
Optional variable | Effect |
| システムID( |
| 内部/不明の CA から発行された証明書を受け入れます。開発専用。 |
| Windows 標準のものではない、SPNEGO サポート付き curl バイナリへのパス。 |
| ノードがエイリアスで公開されている場合、JSON-RPC ICF パスを上書きします。 |
| このサーバーが一覧表示するツール、つまり応答するツールを指定します。後述参照。 |
| 単一の応答の上限(バイト単位)。 |
|
|
| SAP がこのユーザーに ADT ノードを拒否しても、RFC ツールを維持したまま起動します。docs/Authentication.md を参照してください。 |
| フォールバックがログオンする ICF ノード。セッションクッキーと CSRF トークンを発行するだけで十分です。 |
|
|
| Streamable HTTP エンドポイントのポート。デフォルト |
|
|
|
|
|
|
|
|
クライアントに合わせたサーバーのサイジング
ABAP_MCP_* という 3 つの変数が存在する理由は 1 つだけです。ツールスキーマをオンデマンドで取得できないクライアントは、毎回のターンでツールリスト全体のコストを支払うことになるからです。Claude Code はスキーマを遅延取得するため、デフォルトのままにするべきです。128k ウィンドウの 8B モデルは、会話が始まる前にコンテキストの 6 分の 1 を消費しており、"同じプロンプトしか半分しか機能しない"という状態はここから生まれます。
ABAP_MCP_PROFILE — 未設定は all を意味するため、既存のセットアップは変更されません。
profile |
| ターンあたりのコスト | 対象 |
| 9 | ~2,737 tokens | システムの読み取りと編集を 1 つ完了する |
| 18 | ~3,982 tokens | 読み取り専用: ディクショナリ、テーブルデータ、RFC 呼び出し |
| 10 | ~2,900 tokens | RFC 権限を持つが |
| 49 | ~8,034 tokens | 編集サイクルに加え、テスト、ATC、トランスポート、リファクタリング |
| 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 |
|
|
|
|
| TLS 検証を無効にする代わりに、SAP 自身の証明書を検証するための CA バンドル。 |
これは相互 TLS であり、SNC ではありません — ADT は HTTPS です。RFC/SNC で既に機能している証明書は再利用でき、その
CERTRULEマッピングも引き継がれますが、SNC0ACL は関係しませんし、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 セッションクッキーがすべてのリクエストを運ぶため、他のモードと同じであり、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-mcpKerberos モード — イメージには 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-mcpOAuth 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-mcpPassword モード — 最後の手段です!
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 klistdocs/、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-mcpSAP_USER は引き続き必要ですが(パスワード以外のモードでは ADT クライアントを構築するためのプレースホルダーユーザー名が必要)、送信されることはなく、特定のセッションの実際の識別には影響しません。SAP は各セッションの独自のトークンからそれを決定します。§11 と同じです。
変数 | 効果 |
| stdio から Streamable HTTP に切り替える。 |
| 待受ポート。デフォルト |
| バインド先のアドレス。デフォルト |
|
|
| 応答する |
| セッションごとの1分あたりのリクエスト数。 |
他のリモート 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 ではなく名前を受け取ります:
必要なもの | ツール |
クラス、プログラム、インクルード、ファンクショングループ、またはモジュールのソース |
|
テーブル、構造、ビューの概要 |
|
abap の命名規則の背後にあるすべて |
|
{"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
症状 | 原因 / 対処法 |
| Kerberos モード: 有効なチケットがない、またはシステムが SPNEGO を受け付けない — |
| SSO のブートストラップが curl を見つけられませんでした — |
| 原因は |
| 内部 CA が原因です。 |
RFC ツールが |
|
ファンクションモジュールが | そのモジュールが存在しない、RFC が有効でない、または |
クライアントにツールが表示されない |
|
詳細は docs/MCP-Tools.md §8 を参照してください。
コントリビューション
リポジトリをフォークしてください
git checkout -b feature/your-feature-name変更を加え、
npm testとnpx tsc --noEmitが green のままであることを確認してくださいgit commit -m "Add some feature"を実行し、git push origin feature/your-feature-nameを実行してくださいプルリクエストを開いてください
ライセンス
MIT。アップストリームプロジェクトおよび原作者: mario-andreschak。
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Related MCP Connectors
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
Single-connection MCP gateway discovering and executing 490+ verified MCP & A2A tools.
One OAuth connector for your team's remote MCP servers, with Tool Packs, guardrails and logs.
2,000+ MCP servers read at source level. Know what one does before you connect. Free, no key.
Related MCP Servers
- AlicenseCqualityNot gradedmaintenanceAn 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-
- AlicenseCqualityDmaintenanceAn 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.100MIT
- AlicenseNot gradedqualityDmaintenanceA 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
- AlicenseBqualityDmaintenanceMCP 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.100MIT