@mcp-abap-adt/core 2.0.0 → 2.0.2

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 ## [Unreleased]
 
+## [2.0.2] - 2025-12-30
+### Changed
+- **GetWhereUsed handler**: Now uses `getWhereUsedList()` from adt-clients and returns parsed JSON with structured references instead of raw XML
+
+### Fixed
+- **Release workflow**: Simplified to use npm registry instead of uploading tgz artifacts
+
+## [2.0.1] - 2025-12-30
+### Documentation
+- Added glama.ai badge with security/license/quality grades
+- Updated README example to use `EmbeddableMcpServer` instead of deprecated `HandlerExporter.registerOnServer()`
+
 ## [2.0.0] - 2025-12-30
 ### Added
 - **EmbeddableMcpServer**: New server class for external integration (e.g., cloud-llm-hub)

package/README.md

@@ -1,5 +1,9 @@
 # mcp-abap-adt: Your Gateway to ABAP Development Tools (ADT)
 
+<a href="https://glama.ai/mcp/servers/@fr0ster/mcp-abap-adt">
+  <img width="380" height="200" src="https://glama.ai/mcp/servers/@fr0ster/mcp-abap-adt/badge" />
+</a>
+
 > **Acknowledgment**: This project was originally inspired by [mario-andreschak/mcp-abap-adt](https://github.com/mario-andreschak/mcp-abap-adt). We started with the core concept and then evolved it into an independent project with our own architecture and features.
 
 This project provides a server that allows you to interact with SAP ABAP systems using the Model Context Protocol (MCP). Think of it as a bridge that lets tools like [Cline](https://marketplace.visualstudio.com/items?itemName=saoudrizwan.claude-dev) (a VS Code extension) talk to your ABAP system and retrieve information like source code, table structures, and more.
@@ -16,13 +20,17 @@ mcp-abap-adt --transport=http          # HTTP mode
 mcp-abap-adt --transport=sse           # SSE mode
 ```
 
-### 2. Handler Exporter (For Embedding)
-Export handlers for integration into existing servers (e.g., SAP CAP/CDS applications):
+### 2. Embeddable Server (For Integration)
+Embed MCP server into existing applications (e.g., SAP CAP/CDS, Express):
 ```typescript
-import { HandlerExporter } from '@mcp-abap-adt/core/handlers';
-
-const exporter = new HandlerExporter();
-exporter.registerOnServer(mcpServer, () => getConnection());
+import { EmbeddableMcpServer } from '@mcp-abap-adt/core/server';
+
+const server = new EmbeddableMcpServer({
+  connection,              // Your AbapConnection instance
+  logger,                  // Optional logger
+  exposition: ['readonly', 'high'],  // Handler groups to expose
+});
+await server.connect(transport);
 ```
 
 ## Quick Start

package/dist/handlers/system/readonly/handleGetWhereUsed.d.ts

@@ -1,12 +1,12 @@
 /**
  * WhereUsed handler using AdtClient utilities
  * Endpoint: /sap/bc/adt/repository/informationsystem/usageReferences
- * Uses two-step workflow matching Eclipse ADT behavior
+ * Uses getWhereUsedList for parsed results
  */
 import type { HandlerContext } from '../../../lib/handlers/interfaces';
 export declare const TOOL_DEFINITION: {
     readonly name: "GetWhereUsed";
-    readonly description: "[read-only] Retrieve where-used references for ABAP objects via ADT usageReferences. Uses Eclipse ADT-compatible two-step workflow with optional scope customization.";
+    readonly description: "[read-only] Retrieve where-used references for ABAP objects via ADT usageReferences. Returns parsed list of referencing objects with their types and packages.";
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {
@@ -34,10 +34,7 @@ interface WhereUsedArgs {
 }
 /**
  * Returns where-used references for ABAP objects using AdtClient utilities.
- *
- * Two-step workflow:
- * 1. Fetch scope configuration (if enable_all_types is true)
- * 2. Execute where-used search with scope
+ * Uses getWhereUsedList for parsed structured results.
  */
 export declare function handleGetWhereUsed(context: HandlerContext, args: WhereUsedArgs): Promise<{
     isError: boolean;
@@ -48,7 +45,15 @@ export declare function handleGetWhereUsed(context: HandlerContext, args: WhereU
             object_type: string;
             enable_all_types: boolean;
             total_references: number;
-            raw_xml: any;
+            result_description: string;
+            references: {
+                name: string;
+                type: string;
+                uri: string;
+                package_name: string | undefined;
+                responsible: string | undefined;
+                usage_information: string | undefined;
+            }[];
         };
     }[];
 } | {

package/dist/handlers/system/readonly/handleGetWhereUsed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handleGetWhereUsed.d.ts","sourceRoot":"","sources":["../../../../src/handlers/system/readonly/handleGetWhereUsed.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAGvE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;CAyBlB,CAAC;AAEX,UAAU,aAAa;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,aAAa;;;;;;;;;;;;;;;;;;GAyFpB"}
+{"version":3,"file":"handleGetWhereUsed.d.ts","sourceRoot":"","sources":["../../../../src/handlers/system/readonly/handleGetWhereUsed.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAGvE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;CAyBlB,CAAC;AAEX,UAAU,aAAa;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;GAyEpB"}

package/dist/handlers/system/readonly/handleGetWhereUsed.js

@@ -2,7 +2,7 @@
 /**
  * WhereUsed handler using AdtClient utilities
  * Endpoint: /sap/bc/adt/repository/informationsystem/usageReferences
- * Uses two-step workflow matching Eclipse ADT behavior
+ * Uses getWhereUsedList for parsed results
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TOOL_DEFINITION = void 0;
@@ -12,7 +12,7 @@ const getObjectsListCache_1 = require("../../../lib/getObjectsListCache");
 const utils_1 = require("../../../lib/utils");
 exports.TOOL_DEFINITION = {
     name: 'GetWhereUsed',
-    description: '[read-only] Retrieve where-used references for ABAP objects via ADT usageReferences. Uses Eclipse ADT-compatible two-step workflow with optional scope customization.',
+    description: '[read-only] Retrieve where-used references for ABAP objects via ADT usageReferences. Returns parsed list of referencing objects with their types and packages.',
     inputSchema: {
         type: 'object',
         properties: {
@@ -35,10 +35,7 @@ exports.TOOL_DEFINITION = {
 };
 /**
  * Returns where-used references for ABAP objects using AdtClient utilities.
- *
- * Two-step workflow:
- * 1. Fetch scope configuration (if enable_all_types is true)
- * 2. Execute where-used search with scope
+ * Uses getWhereUsedList for parsed structured results.
  */
 async function handleGetWhereUsed(context, args) {
     const { connection, logger } = context;
@@ -55,36 +52,28 @@ async function handleGetWhereUsed(context, args) {
         // Create AdtClient and get utilities
         const client = new adt_clients_1.AdtClient(connection, logger);
         const utils = client.getUtils();
-        let scopeXml;
-        // Step 1: If enable_all_types is true, fetch and modify scope
-        if (typedArgs.enable_all_types === true) {
-            logger?.info('Fetching scope with all types enabled (Eclipse "select all" behavior)');
-            const scopeResponse = await utils.getWhereUsedScope({
-                object_name: typedArgs.object_name,
-                object_type: typedArgs.object_type,
-            });
-            // Modify scope to enable all types
-            scopeXml = utils.modifyWhereUsedScope(scopeResponse.data, {
-                enableAll: true,
-            });
-        }
-        // Step 2: Execute where-used search
-        // If scopeXml is undefined, getWhereUsed will auto-fetch default scope
-        const result = await utils.getWhereUsed({
+        // Use getWhereUsedList for parsed results
+        const result = await utils.getWhereUsedList({
             object_name: typedArgs.object_name,
             object_type: typedArgs.object_type,
-            scopeXml,
+            enableAllTypes: typedArgs.enable_all_types,
         });
-        logger?.debug(`Where-used search completed for ${typedArgs.object_type}/${typedArgs.object_name}`);
-        // Parse numberOfResults from XML
-        const numberOfResults = result.data?.match(/numberOfResults="(\d+)"/)?.[1] || '0';
-        // Format response
+        logger?.debug(`Where-used search completed for ${typedArgs.object_type}/${typedArgs.object_name}: ${result.totalReferences} references`);
+        // Format response with parsed data
         const formattedResponse = {
-            object_name: typedArgs.object_name,
-            object_type: typedArgs.object_type,
+            object_name: result.objectName,
+            object_type: result.objectType,
             enable_all_types: typedArgs.enable_all_types || false,
-            total_references: parseInt(numberOfResults, 10),
-            raw_xml: result.data,
+            total_references: result.totalReferences,
+            result_description: result.resultDescription,
+            references: result.references.map((ref) => ({
+                name: ref.name,
+                type: ref.type,
+                uri: ref.uri,
+                package_name: ref.packageName,
+                responsible: ref.responsible,
+                usage_information: ref.usageInformation,
+            })),
         };
         const mcpResult = {
             isError: false,

package/dist/handlers/system/readonly/handleGetWhereUsed.js.map

@@ -1 +1 @@
-{"version":3,"file":"handleGetWhereUsed.js","sourceRoot":"","sources":["../../../../src/handlers/system/readonly/handleGetWhereUsed.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"handleGetWhereUsed.js","sourceRoot":"","sources":["../../../../src/handlers/system/readonly/handleGetWhereUsed.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-abap-adt/core",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {