MCP ABAP ADT

🚀 MCP 協議 ABAP 工具安裝指南

本工具旨在幫助用戶高效使用 MCP 協議 ABAP 相關功能，以下為您詳細介紹其安裝、使用及常見問題排查等內容。

🚀 快速開始

克隆項目

首先，您需要將項目克隆到本地，並進入項目目錄：

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

配置環境變量

編輯項目根目錄下的 .env 文件，根據實際情況修改 SAP 相關配置：

SAP_CLIENT=001  # SAP Client 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

安裝依賴項

在項目目錄下運行以下命令，安裝項目所需的依賴：

npm install

構建項目

安裝完依賴後，運行以下命令構建項目：

npm run build

啟動服務

最後，啟動 MCP 協議 ABAP 工具服務：

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

MCP 協議 ABAP 工具可用性檢查

啟動服務後，可以通過以下 URL 訪問工具：

• Web UI：http://localhost:3000/ui
• API 文檔：http://localhost:3000/docs

💻 使用示例

可用工具

以下是當前 MCP 協議 ABAP 工具支持的命令及其使用說明：

基礎用法

• 獲取幫助信息

npx @modelcontextprotocol/core help

• 運行時檢查

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

• 打印日誌

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