MCP ABAP ADT

🚀 MCP プロトコル ABAP ツールのインストールガイド

MCP プロトコル ABAP ツールは、特定の業務システムとの連携やデータ処理を行うためのツールです。このガイドでは、このツールのインストール、設定、使用方法について詳しく説明します。

🚀 クイックスタート

インストール手順

1. プロジェクトのクローン

git clone https://github.com/your-repository.git
cd mcp-abap-adt

2. 環境変数の設定

.env ファイルを編集します。

SAP_CLIENT=001  # SAP クライアント ID，デフォルトは001
SAP_SERVER=192.168.1.100  # SAP サーバーアドレス，実際の設定に合わせて変更
SAP_PORT=3200  # SAP ポート，デフォルトは3200
SAP_USER=user  # SAP ユーザー名，デフォルトはuser
SAP_PASSWORD=password  # SAP パスワード，デフォルトはpassword
SAP_LANG=en  # SAP 言語，デフォルトはen（英語）
TLS_REJECT_UNAUTHORIZED=false  # 自己署名証明書を拒否するかどうか，デフォルトはfalse

3. 依存関係のインストール

以下のコマンドを実行します。

npm install

4. プロジェクトのビルド

以下のコマンドを実行します。

npm run build

5. サービスの起動

以下のコマンドを実行します。

npx @modelcontextprotocol/core serve dist/index.js

起動前のチェック

以下の条件が満たされていることを確認してください。

1. Node.js バージョン >= 14.x
2. npm バージョン >= 6.x
3. ネットワーク接続が正常で、SAP システムにアクセスできること
4. SAP システムで ADT（ABAP Development Tools）サービスが有効になっていること

以下のコマンドを実行してサービスの状態を確認します。

curl http://localhost:3000/api/healthz

.env ファイルの作成

プロジェクトのルートディレクトリに .env ファイルを作成し、以下の内容を記述します。

SAP_CLIENT=001  # SAP クライアント番号，デフォルトは001
SAP_SERVER=192.168.1.100  # SAP サーバーアドレス，デフォルトは192.168.1.100
SAP_PORT=3200  # SAP ポート，デフォルトは3200
SAP_USER=user  # SAP ユーザー名，デフォルトはuser
SAP_PASSWORD=password  # SAP パスワード，デフォルトはpassword
SAP_LANG=en  # SAP 言語，デフォルトはen（英語）
TLS_REJECT_UNAUTHORIZED=false  # 自己署名証明書を拒否するかどうか，デフォルトはfalse

依存関係のインストール

以下のコマンドを実行して、プロジェクトに必要な依存関係をインストールします。

npm install @modelcontextprotocol/core @modelcontextprotocol/types @types/node --save

MCP サービスの起動

上記の手順を完了したら、MCP プロトコル ABAP ツールを起動します。

npx @modelcontextprotocol/inspector serve dist/index.js

SAP 接続問題のトラブルシューティング

SAP システムに接続できない場合は、以下の内容を確認してください。

1. SAP サーバーアドレスとポートが正しいこと
2. SAP ユーザー名とパスワードが正しいこと
3. ネットワーク接続が正常であること
4. SAP システムでリモートアクセス機能が有効になっていること

以下のコマンドを実行して接続をテストします。

curl http://localhost:3000/api/test-connectivity

ツールの可用性チェック

サービスを起動した後、以下の URL からツールにアクセスできます。

• Web UI：http://localhost:3000/ui
• API ドキュメント：http://localhost:3000/docs

💻 使用例

基本的な使用法

1. ヘルプ情報の取得

npx @modelcontextprotocol/core help

2. ランタイムチェック

npx @modelcontextprotocol/core check --server http://localhost:3000

3. ログの表示

npx @modelcontextprotocol/core logs --level debug

📚 ドキュメント

エラーコード

以下は、一般的なエラーコードとその説明です。

1. ECONNREFUSED - 接続が拒否されました。通常は、SAP サービスが起動していないか、アドレスが間違っているためです。
2. ETIMEOUT - 接続がタイムアウトしました。ネットワークの問題または SAP サービスが利用できない可能性があります。
3. BAD_REQUEST - リクエストの形式が間違っています。リクエストパラメータが正しいか確認してください。
4. Unauthorized - 認証されていません。ユーザー権限を確認してください。
5. NotFound - リソースが見つかりません。パスとエンドポイントが正しいことを確認してください。

ログ記録

ツールは詳細なログ記録をサポートしており、以下のコマンドで確認できます。

npx @modelcontextprotocol/core logs --level debug

設定ファイルの位置

デフォルトでは、ツールはプロジェクトのルートディレクトリにある .env ファイルを探します。他のパスを指定する場合は、実行時に --config パラメータを使用してください。

npx @modelcontextprotocol/core serve dist/index.js --config ./custom-config.json

バージョン情報

現在のツールのバージョンを確認するには、以下のコマンドを実行します。

npx @modelcontextprotocol/core version

付録：MCP プロトコル ABAP ツール API ドキュメント

完全な API ドキュメントは、以下のリンクからアクセスできます。

• Swagger UI: http://localhost:3000/docs
• OpenAPI 仕様: http://localhost:3000/swagger.json