refactor: rename endpoint tool to test_request and improve build process

- Rename endpoint tool to test_request for better clarity
- Add dynamic response size limit information in tool description
- Remove redundant postbuild script
- Update documentation and examples with proper MCP tool usage

Author: dkmaker

CLINE-CUSTOM-INSTRUCTIONS.md

@@ -1,6 +1,6 @@
 # REST API Testing Instructions
 
-Use this tool when testing, debugging, or interacting with REST API endpoints. The tool provides comprehensive request/response information and handles authentication automatically.
+The `test_request` tool enables testing, debugging, and interacting with REST API endpoints. The tool provides comprehensive request/response information and handles authentication automatically.
 
 ## When to Use
 

README.md

@@ -52,7 +52,9 @@ Add to `C:\Users\<YourUsername>\AppData\Roaming\Code\User\globalStorage\saoudriz
         "AUTH_APIKEY_HEADER_NAME": "X-API-Key",
         "AUTH_APIKEY_VALUE": "your-api-key",
         // SSL Verification (enabled by default)
-        "REST_ENABLE_SSL_VERIFY": "false" // Set to false to disable SSL verification for self-signed certificates
+        "REST_ENABLE_SSL_VERIFY": "false", // Set to false to disable SSL verification for self-signed certificates
+        // Response Size Limit (optional, defaults to 10000 bytes)
+        "REST_RESPONSE_SIZE_LIMIT": "10000" // Maximum response size in bytes
       }
     }
   }
@@ -100,6 +102,12 @@ Note: Replace the environment variables with your actual values. Only configure
 - Detailed response information including status, headers, and body
 - Custom header support
 - Request body handling for POST/PUT methods
+- Response Size Management:
+  - Automatic response size limiting (default: 10KB/10000 bytes)
+  - Configurable size limit via REST_RESPONSE_SIZE_LIMIT environment variable
+  - Clear truncation metadata when responses exceed limit
+  - Preserves response structure while only truncating body content
+
 - SSL Certificate Verification:
   - Enabled by default for secure operation
   - Can be disabled for self-signed certificates or development environments
@@ -115,30 +123,30 @@ Once installed and configured, you can use the REST API Tester through Cline to
 
 ```typescript
 // Test a GET endpoint
-{
+use_mcp_tool('rest-api', 'test_request', {
   "method": "GET",
   "endpoint": "/users"
-}
+});
 
 // Test a POST endpoint with body
-{
+use_mcp_tool('rest-api', 'test_request', {
   "method": "POST",
   "endpoint": "/users",
   "body": {
     "name": "John Doe",
     "email": "john@example.com"
   }
-}
+});
 
 // Test with custom headers
-{
+use_mcp_tool('rest-api', 'test_request', {
   "method": "GET",
   "endpoint": "/products",
   "headers": {
     "Accept-Language": "en-US",
     "X-Custom-Header": "custom-value"
   }
-}
+});
 ```
 
 ## Development

package.json

@@ -16,7 +16,6 @@
   "scripts": {
     "prebuild": "node scripts/build.js",
     "build": "tsc",
-    "postbuild": "node scripts/build.js",
     "prepare": "npm run build",
     "watch": "tsc --watch",
     "inspector": "npx @modelcontextprotocol/inspector build/index.js"

src/index.ts

@@ -10,11 +10,20 @@ import {
   McpError,
 } from '@modelcontextprotocol/sdk/types.js';
 import axios, { AxiosInstance, AxiosRequestConfig, Method } from 'axios';
-import { VERSION, PACKAGE_NAME, SERVER_NAME } from './version.js';
+import { VERSION, SERVER_NAME } from './version.js';
 
 if (!process.env.REST_BASE_URL) {
   throw new Error('REST_BASE_URL environment variable is required');
 }
+
+// Default response size limit: 10KB (10000 bytes)
+const RESPONSE_SIZE_LIMIT = process.env.REST_RESPONSE_SIZE_LIMIT 
+  ? parseInt(process.env.REST_RESPONSE_SIZE_LIMIT, 10)
+  : 10000;
+
+if (isNaN(RESPONSE_SIZE_LIMIT) || RESPONSE_SIZE_LIMIT <= 0) {
+  throw new Error('REST_RESPONSE_SIZE_LIMIT must be a positive number');
+}
 const AUTH_BASIC_USERNAME = process.env.AUTH_BASIC_USERNAME;
 const AUTH_BASIC_PASSWORD = process.env.AUTH_BASIC_PASSWORD;
 const AUTH_BEARER = process.env.AUTH_BEARER;
@@ -29,6 +38,35 @@ interface EndpointArgs {
   headers?: Record<string, string>;
 }
 
+interface ValidationResult {
+  isError: boolean;
+  messages: string[];
+  truncated?: {
+    originalSize: number;
+    returnedSize: number;
+    truncationPoint: number;
+    sizeLimit: number;
+  };
+}
+
+interface ResponseObject {
+  request: {
+    url: string;
+    method: string;
+    headers: Record<string, string | undefined>;
+    body: any;
+    authMethod: string;
+  };
+  response: {
+    statusCode: number;
+    statusText: string;
+    timing: string;
+    headers: Record<string, any>;
+    body: any;
+  };
+  validation: ValidationResult;
+}
+
 const isValidEndpointArgs = (args: any): args is EndpointArgs => {
   if (typeof args !== 'object' || args === null) return false;
   if (!['GET', 'POST', 'PUT', 'DELETE'].includes(args.method)) return false;
@@ -145,7 +183,7 @@ class RestTester {
     this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
       tools: [
         {
-          name: 'endpoint',
+          name: 'test_request',
           description: `Test a REST API endpoint and get detailed response information. 
 
 Base URL: ${process.env.REST_BASE_URL}
@@ -166,6 +204,7 @@ The tool automatically:
 - Normalizes endpoints (adds leading slash, removes trailing slashes)
 - Handles authentication header injection
 - Accepts any HTTP status code as valid
+- Limits response size to ${RESPONSE_SIZE_LIMIT} bytes (configurable via REST_RESPONSE_SIZE_LIMIT)
 - Returns detailed response information including:
   * Full URL called
   * Status code and text
@@ -211,7 +250,7 @@ Error Handling:
     }));
 
     this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
-      if (request.params.name !== 'endpoint') {
+      if (request.params.name !== 'test_request') {
         throw new McpError(
           ErrorCode.MethodNotFound,
           `Unknown tool: ${request.params.name}`
@@ -271,32 +310,62 @@ Error Handling:
         else if (hasBearerAuth()) authMethod = 'bearer';
         else if (hasApiKeyAuth()) authMethod = 'apikey';
 
+        // Prepare response object
+        const responseObj: ResponseObject = {
+          request: {
+            url: fullUrl,
+            method: config.method || 'GET',
+          headers: config.headers as Record<string, string | undefined>,
+            body: config.data,
+            authMethod
+          },
+          response: {
+            statusCode: response.status,
+            statusText: response.statusText,
+            timing: `${endTime - startTime}ms`,
+          headers: response.headers as Record<string, any>,
+            body: response.data,
+          },
+          validation: {
+            isError: response.status >= 400,
+            messages: response.status >= 400 ? 
+              [`Request failed with status ${response.status}`] : 
+              ['Request completed successfully']
+          }
+        };
+
+        // Check response size
+        const stringified = JSON.stringify(responseObj, null, 2);
+        const totalBytes = Buffer.from(stringified).length;
+
+        if (totalBytes > RESPONSE_SIZE_LIMIT) {
+          // Convert body to string if it isn't already
+          const bodyStr = typeof response.data === 'string' 
+            ? response.data 
+            : JSON.stringify(response.data);
+          
+          // Calculate how much we need to truncate
+          const currentSize = Buffer.from(bodyStr).length;
+          const targetSize = Math.max(0, currentSize - (totalBytes - RESPONSE_SIZE_LIMIT));
+          
+          // Create truncated response
+          responseObj.response.body = bodyStr.slice(0, targetSize);
+          responseObj.validation.messages.push(
+            `Response truncated: ${targetSize} of ${currentSize} bytes returned due to size limit (${RESPONSE_SIZE_LIMIT} bytes)`
+          );
+          responseObj.validation.truncated = {
+            originalSize: currentSize,
+            returnedSize: targetSize,
+            truncationPoint: targetSize,
+            sizeLimit: RESPONSE_SIZE_LIMIT
+          };
+        }
+
         return {
           content: [
             {
               type: 'text',
-              text: JSON.stringify({
-                request: {
-                  url: fullUrl,
-                  method: config.method,
-                  headers: config.headers,
-                  body: config.data,
-                  authMethod
-                },
-                response: {
-                  statusCode: response.status,
-                  statusText: response.statusText,
-                  timing: `${endTime - startTime}ms`,
-                  headers: response.headers,
-                  body: response.data,
-                },
-                validation: {
-                  isError: response.status >= 400,
-                  messages: response.status >= 400 ? 
-                    [`Request failed with status ${response.status}`] : 
-                    ['Request completed successfully']
-                }
-              }, null, 2),
+              text: JSON.stringify(responseObj, null, 2),
             },
           ],
         };

src/resources/examples.md

@@ -2,59 +2,59 @@
 
 ## Basic GET Request
 ```typescript
-{
+use_mcp_tool('rest-api', 'test_request', {
   "method": "GET",
   "endpoint": "/users"
-}
+});
 ```
 
 ## GET with Query Parameters
 ```typescript
-{
+use_mcp_tool('rest-api', 'test_request', {
   "method": "GET",
   "endpoint": "/users?role=admin&status=active"
-}
+});
 ```
 
 ## POST Request with Body
 ```typescript
-{
+use_mcp_tool('rest-api', 'test_request', {
   "method": "POST",
   "endpoint": "/users",
   "body": {
     "name": "John Doe",
     "email": "john@example.com"
   }
-}
+});
 ```
 
 ## Request with Custom Headers
 ```typescript
-{
+use_mcp_tool('rest-api', 'test_request', {
   "method": "GET",
   "endpoint": "/secure-resource",
   "headers": {
     "Custom-Header": "value",
     "Another-Header": "another-value"
   }
-}
+});
 ```
 
 ## PUT Request Example
 ```typescript
-{
+use_mcp_tool('rest-api', 'test_request', {
   "method": "PUT",
   "endpoint": "/users/123",
   "body": {
     "name": "Updated Name",
     "status": "inactive"
   }
-}
+});
 ```
 
 ## DELETE Request Example
 ```typescript
-{
+use_mcp_tool('rest-api', 'test_request', {
   "method": "DELETE",
   "endpoint": "/users/123"
-}
+});