ebay-api-mcp-server-node-local 1.0.0

package/dist/helper/validation-helper.js

@@ -0,0 +1,214 @@
+import AjvLib from "ajv";
+const Ajv = AjvLib.default || AjvLib;
+/**
+ * Validate request parameters against OpenAPI specification
+ */
+export function validateRequestParameters(url, openApiDoc, method, input) {
+    const errors = [];
+    // validate path
+    const { pathValidateRes, apiPath, specPath, specPathItem } = validatePath(openApiDoc, url);
+    if (!pathValidateRes || !specPathItem) {
+        errors.push(`API path ${apiPath} is not valid or not found in OpenAPI specification`);
+        return { isValid: false, errors };
+    }
+    // Check if the method exists for the path
+    const operation = specPathItem[method.toLowerCase()];
+    if (!operation) {
+        errors.push(`Method ${method} not found for path ${specPath} in OpenAPI specification`);
+        return { isValid: false, errors };
+    }
+    // Initialize AJV for schema validation
+    const _ajv = new Ajv({ allErrors: true });
+    validateUrlPathParam(input.urlVariables, operation.parameters, errors);
+    validateUrlQueryParam(input.urlQueryParams, operation.parameters, errors);
+    validateUrlHeaders(input.headers, operation.parameters, errors);
+    validateUrlRequestBody(input.requestBody, operation.requestBody, errors);
+    return { isValid: errors.length === 0, errors };
+}
+/**
+ *  Validate the API path against the OpenAPI document
+ */
+export function validatePath(openApiDoc, inputUrl) {
+    // Extract the path from the URL (remove base URL part)
+    const apiPath = parseApiPathFromUrl(inputUrl);
+    if (!apiPath) {
+        console.error(`input url ${inputUrl} is not valid, please check it.`);
+        return { pathValidateRes: false, apiPath: "", specPath: "", specPathItem: undefined };
+    }
+    // bathPath validation
+    const serverObj = openApiDoc.servers?.[0] || { url: "" };
+    let basePath = "";
+    if (serverObj?.variables) {
+        for (const [key, value] of Object.entries(serverObj.variables)) {
+            if (key === "basePath") {
+                basePath = value.default;
+            }
+        }
+    }
+    const basePathRegex = new RegExp(`${basePath.replace(/\{[^}]+\}/g, "[^/]+")}$`);
+    if (basePath && !basePathRegex.test(apiPath)) {
+        console.error(`API path ${apiPath} does not match the base path ${basePath} in OpenAPI specification.`);
+        return { pathValidateRes: false, apiPath, specPath: "", specPathItem: undefined };
+    }
+    // specPath validation
+    for (const specPath of Object.keys(openApiDoc.paths || {})) {
+        const specPathRegex = new RegExp(`${specPath.replace(/\{[^}]+\}/g, "[^/]+")}$`);
+        if (specPathRegex.test(apiPath) && openApiDoc.paths?.[specPath]) {
+            const specPathItem = openApiDoc.paths[specPath];
+            return { pathValidateRes: true, apiPath, specPath, specPathItem };
+        }
+    }
+    return { pathValidateRes: false, apiPath, specPath: "", specPathItem: undefined };
+}
+/**
+ *  parse path from the given url by llm
+ */
+export function parseApiPathFromUrl(inputUrl) {
+    try {
+        const urlObj = new URL(inputUrl);
+        return decodeURIComponent(urlObj.pathname); // Decode URL path
+    }
+    catch (urlError) {
+        // If URL parsing fails, try to extract path manually
+        const pathMatch = inputUrl.match(/https?:\/\/[^/]+(.*)$/);
+        if (pathMatch) {
+            return pathMatch[1];
+        }
+        console.error(`Failed to parse API path from URL: ${inputUrl}`);
+        return "";
+    }
+}
+/**
+ *  Validate URL path parameters against OpenAPI specification
+ */
+export function validateUrlPathParam(urlVariables, parameters, errors) {
+    // Initialize AJV for schema validation
+    const ajv = new Ajv({ allErrors: true });
+    if (urlVariables) {
+        const pathParams = (parameters || []).filter((param) => !("$ref" in param) && param.in === "path");
+        for (const param of pathParams) {
+            const value = urlVariables[param.name];
+            if (param.required && (value === undefined || value === null)) {
+                errors.push(`Missing required path parameter: ${param.name}`);
+                continue;
+            }
+            if (value !== undefined && param.schema) {
+                const validate = ajv.compile(param.schema);
+                if (!validate(value)) {
+                    errors.push(`Invalid path parameter ${param.name}: ${ajv.errorsText(validate.errors)}`);
+                }
+            }
+        }
+        // Check for extra path parameters not defined in spec
+        const definedPathParams = pathParams.map(p => p.name);
+        const extraParams = Object.keys(urlVariables).filter(key => !definedPathParams.includes(key));
+        if (extraParams.length > 0) {
+            errors.push(`Unknown path parameters: ${extraParams.join(", ")}`);
+        }
+        // Check for required path parameters that might be missing from urlVariables
+        const requiredPathParams = (parameters || [])
+            .filter((param) => !("$ref" in param) && param.in === "path" && (param.required === true))
+            .map(param => param.name);
+        const providedPathParams = Object.keys(urlVariables || {});
+        const missingPathParams = requiredPathParams.filter(param => !providedPathParams.includes(param));
+        if (missingPathParams.length > 0) {
+            errors.push(`Missing required path parameters: ${missingPathParams.join(", ")}`);
+        }
+    }
+}
+/**
+ * Validate URL query parameters against OpenAPI specification
+ */
+export function validateUrlQueryParam(urlQueryParams, parameters, errors) {
+    const ajv = new Ajv({ allErrors: true });
+    if (urlQueryParams) {
+        const queryParams = (parameters || []).filter((param) => !("$ref" in param) && param.in === "query");
+        for (const param of queryParams) {
+            const value = urlQueryParams[param.name];
+            if (param.required && (value === undefined || value === null || value === "")) {
+                errors.push(`Missing required query parameter: ${param.name}`);
+                continue;
+            }
+            if (value !== undefined && param.schema) {
+                const validate = ajv.compile(param.schema);
+                // Convert string values to appropriate types for validation
+                let validationValue = value;
+                if (typeof value === "string" && param.schema && !("$ref" in param.schema) && (param.schema).type) {
+                    const schemaObj = param.schema;
+                    switch (schemaObj.type) {
+                        case "integer":
+                        case "number":
+                            validationValue = Number(value);
+                            break;
+                        case "boolean":
+                            validationValue = value.toLowerCase() === "true";
+                            break;
+                        case "array":
+                            // Handle comma-separated values for arrays
+                            if (param.style === "form" && !param.explode) {
+                                validationValue = value.split(",");
+                            }
+                            break;
+                    }
+                }
+                if (!validate(validationValue)) {
+                    errors.push(`Invalid query parameter ${param.name}: ${ajv.errorsText(validate.errors)}`);
+                }
+            }
+        }
+    }
+}
+/**
+ * Validate URL headers against OpenAPI specification
+ */
+export function validateUrlHeaders(headers, parameters, errors) {
+    const ajv = new Ajv({ allErrors: true });
+    if (headers) {
+        const headerParams = (parameters || []).filter((param) => !("$ref" in param) && param.in === "header");
+        for (const param of headerParams) {
+            const headerName = param.name.toLowerCase();
+            const value = headers[headerName] || headers[param.name];
+            if (param.required && (value === undefined || value === null || value === "")) {
+                errors.push(`Missing required header parameter: ${param.name}`);
+                continue;
+            }
+            if (value !== undefined && param.schema) {
+                const validate = ajv.compile(param.schema);
+                if (!validate(value)) {
+                    errors.push(`Invalid header parameter ${param.name}: ${ajv.errorsText(validate.errors)}`);
+                }
+            }
+        }
+    }
+}
+/**
+ *  Validate URL request body against OpenAPI specification
+ */
+export function validateUrlRequestBody(inputBody, operationBody, errors) {
+    const ajv = new Ajv({ allErrors: true, strict: false });
+    if (operationBody && !("$ref" in operationBody)) {
+        const requestBody = operationBody;
+        const isRequired = requestBody.required || false;
+        if (isRequired && (!inputBody || Object.keys(inputBody).length === 0)) {
+            errors.push("Missing required request body");
+        }
+        else if (inputBody && Object.keys(inputBody).length > 0) {
+            // Find the appropriate content type schema
+            const contentTypes = ["application/json", "application/x-www-form-urlencoded", "multipart/form-data"];
+            let schema;
+            for (const contentType of contentTypes) {
+                if (requestBody.content?.[contentType]?.schema) {
+                    schema = requestBody.content[contentType].schema;
+                    break;
+                }
+            }
+            if (schema) {
+                const validate = ajv.compile(schema);
+                if (!validate(inputBody)) {
+                    errors.push(`Invalid request body: ${ajv.errorsText(validate.errors)}`);
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=validation-helper.js.map

package/dist/helper/validation-helper.js.map

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

package/dist/index.js

@@ -0,0 +1,65 @@
+// Load environment variables from .env file
+import * as dotenv from "dotenv";
+dotenv.config();
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerOpenApiTools } from "./service/openapi-service.js";
+import * as constants from "./constant/constants.js";
+/**
+ * Check if required environment variables are set for eBay API authentication
+ */
+function checkEnvironmentVariables() {
+    // environment vals check
+    const missingVars = constants.REQUIRED_ENV_VARS.filter(varName => !process.env[varName]);
+    if (missingVars.length > 0) {
+        console.error(`Missing required environment variables: ${missingVars.join(", ")}`);
+        process.exit(1);
+    }
+    if (process.env.EBAY_ENVIRONMENT &&
+        !["sandbox", "production"].includes(process.env.EBAY_ENVIRONMENT.toLowerCase())) {
+        console.warn("Warning: EBAY_ENVIRONMENT must be either \"sandbox\" or \"production\"");
+        console.warn(`Current value "${process.env.EBAY_ENVIRONMENT}" is invalid, defaulting to "production"`);
+    }
+}
+/**
+ * Main function to initialize and run the eBay API MCP Server
+ * This server exposes eBay API endpoints as MCP tools for access via AI models
+ */
+async function main() {
+    console.error("Starting eBay API MCP Server...");
+    // Check for required environment variables
+    checkEnvironmentVariables();
+    const server = initServer();
+    try {
+        // Register the OpenAPI tools with the server
+        await registerOpenApiTools(server);
+        console.error("Successfully registered OpenAPI tools");
+        // Create and connect server transport
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        console.error("eBay API MCP Server running on stdio transport");
+    }
+    catch (error) {
+        console.error("Error starting MCP server:", error instanceof Error ? error.message : String(error));
+        console.error("Stack trace:", error instanceof Error ? error.stack : "No stack trace available");
+        process.exit(1);
+    }
+}
+// Run the server
+main().catch((error) => {
+    console.error("Fatal error:", error instanceof Error ? error.message : String(error));
+    console.error("Stack trace:", error instanceof Error ? error.stack : "No stack trace available");
+    process.exit(1);
+});
+// Create MCP server instance
+function initServer() {
+    return new McpServer({
+        name: "ebay-api-mcp-server",
+        version: "1.0.0",
+        capabilities: {
+            resources: {},
+            tools: {},
+        },
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/service/openapi-service.js

@@ -0,0 +1,196 @@
+import { z } from "zod";
+import axios from "axios";
+import util from "util";
+import { RECALL_SPEC_BY_PROMPT_URL, RECALL_SPEC_WITH_FIELD_URL, SUPPORTED_CALLING_METHODS, findApiEnvironmentByValue } from "../constant/constants.js";
+import { getOpenApiDocumentsFromConfigFile, parseOpenApiDoc, buildOperationSchema, buildZodSchema } from "../helper/openapi-helper.js";
+import { validateRequestParameters as validateRequestParametersFromHelper } from "../helper/validation-helper.js";
+import { buildHeadersFromInput, buildFinalUrl, replaceDomainNameByEnvironment, formatAxiosError, buildBaseUrlFromOpenApi, prepareRequestData } from "../helper/http-helper.js";
+const USER_ENVIRONMENT = findApiEnvironmentByValue(process.env.EBAY_API_ENV || "");
+const QUERY_API_TOOL_DISCRIPTION = "Send user prompt to remote service and return recommended API spec info (GET, query param, path...). " +
+    "Only output the tool response. Don't add any unnecessary text to it.";
+const INVOKE_API_TOOL_DISCRIPTION = "this tool requires the prior invocation of tool queryAPI to ensure proper context, please ensure tool queryAPI has been successfully executed before using this tool." +
+    "the output of tool queryAPI will be used to generate input parameter of this tool. please ensure each field type of input parameter complies with the specifications required by the api spec." +
+    "after validation , this tool will invoke eBay OpenAPI and return the result." +
+    "if the tool return error, please check the error info and give advice or fix it.";
+/**
+ * Register OpenAPI tools with MCP server
+ */
+export async function registerOpenApiTools(server) {
+    // Load OpenAPI document
+    const openapis = await getOpenApiDocumentsFromConfigFile();
+    for (const doc of openapis) {
+        registerOpenApiDynamicTools(server, doc);
+    }
+    registerCustomTools(server);
+}
+/**
+ * register OpenAPI tools dynamically based on the OpenAPI document
+ */
+function registerOpenApiDynamicTools(server, openapi) {
+    const baseUrl = buildBaseUrlFromOpenApi(openapi);
+    Object.entries(openapi.paths || {})
+        .filter(([_, pathItem]) => pathItem !== undefined)
+        .forEach(([path, pathItem]) => registerPathOperations(server, baseUrl, path, pathItem));
+}
+/**
+ * Register tools for operations in a specific path
+ */
+function registerPathOperations(server, baseUrl, path, pathItem) {
+    const supportedMethods = Object.keys(pathItem)
+        .filter(method => SUPPORTED_CALLING_METHODS[USER_ENVIRONMENT].includes(method));
+    supportedMethods.forEach(method => {
+        const operation = pathItem[method];
+        if (operation && operation.operationId) {
+            registerOperation(server, baseUrl, path, method, operation);
+        }
+    });
+}
+/**
+ * Register tool for a single API operation
+ */
+function registerOperation(server, baseUrl, path, method, operation) {
+    const properties = buildOperationSchema(operation);
+    const zodProperties = buildZodSchema(properties);
+    server.tool(operation.operationId || "unknownOperation", operation.description || "No description", zodProperties, async (input, _extra) => {
+        try {
+            const { resolvedPath, headers, params, data } = prepareRequestData(input, operation, path);
+            const url = baseUrl + resolvedPath;
+            const resp = await axios.request({
+                url,
+                method,
+                headers,
+                params,
+                data,
+                httpsAgent: new (await import("https")).Agent({
+                    rejectUnauthorized: false,
+                })
+            });
+            return {
+                content: [
+                    { type: "text", text: typeof resp.data === "string" ? resp.data : JSON.stringify(resp.data, null, 2) },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    { type: "text", text: `Error in invokeOpenAPI tool: ${formatAxiosError(error)}` },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+/**
+ * Register custom API tools to enable interaction with eBay OpenAPI services
+ * This function registers two primary tools:
+ * 1. queryAPI - For discovering API specifications
+ * 2. invokeAPI - For executing API calls with validation
+ */
+function registerCustomTools(server) {
+    registerQueryApiTool(server);
+    registerInvokeApiTool(server);
+}
+/**
+ * Register a tool for querying API specifications based on natural language prompts
+ * Only registered when no custom API doc URL file is provided
+ */
+function registerQueryApiTool(server) {
+    const hasCustomDoc = process.env.EBAY_API_DOC_URL_FILE;
+    if (hasCustomDoc) {
+        return;
+    }
+    server.tool("queryAPI", QUERY_API_TOOL_DISCRIPTION, { prompt: z.string() }, async (input) => {
+        try {
+            const url = util.format(RECALL_SPEC_BY_PROMPT_URL, encodeURIComponent(input.prompt));
+            const resp = await axios.get(url, {
+                httpsAgent: new (await import("https")).Agent({
+                    rejectUnauthorized: false,
+                }),
+            });
+            return {
+                content: [
+                    { type: "text", text: resp.data ? (typeof resp.data === "string" ? resp.data : JSON.stringify(resp.data, null, 2)) : "No response body" }
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    { type: "text", text: `Error: ${error instanceof Error ? error.message : String(error)}` },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+/**
+ * Register a tool for executing API calls with proper validation and error handling
+ */
+function registerInvokeApiTool(server) {
+    server.tool("invokeAPI", INVOKE_API_TOOL_DISCRIPTION, getInvokeApiSchema(), async (input, _extra) => {
+        try {
+            // Build headers
+            const headers = buildHeadersFromInput(input.headers);
+            // query and parse apiSpec by specTitle and operationId
+            const openApiDoc = await parseOpenApiDoc(input.specTitle, input.operationId, RECALL_SPEC_WITH_FIELD_URL);
+            const replacedDomainUrl = replaceDomainNameByEnvironment(input.url);
+            // Validate req parameters against OpenAPI spec
+            const reqParamValidation = validateRequestParametersFromHelper(replacedDomainUrl, openApiDoc, input.method, {
+                urlVariables: input.urlVariables,
+                urlQueryParams: input.urlQueryParams,
+                headers,
+                requestBody: input.requestBody,
+            });
+            if (!reqParamValidation.isValid) {
+                return {
+                    content: [
+                        { type: "text", text: "Request validation failed:" },
+                        { type: "text", text: reqParamValidation.errors.join("\n") },
+                    ],
+                    isError: true,
+                };
+            }
+            // Make the API request
+            const resp = await axios.request({
+                url: buildFinalUrl(replacedDomainUrl, input.urlVariables),
+                method: input.method,
+                headers,
+                params: input.urlQueryParams,
+                data: input.requestBody,
+                httpsAgent: new (await import("https")).Agent({
+                    rejectUnauthorized: false,
+                }),
+            });
+            return {
+                content: [
+                    { type: "text", text: resp.data ? (typeof resp.data === "string" ? resp.data : JSON.stringify(resp.data, null, 2)) : "No response body" },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    { type: "text", text: `Error in invokeOpenAPI tool: ${formatAxiosError(error)}` },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+/**
+ * Define the schema for invokeAPI tool parameters
+ */
+function getInvokeApiSchema() {
+    return {
+        url: z.string().describe("The complete request API URL, url and basePath need to be put in together. don't replace path variables, maintain variables such as {item_id}, the variable will be replaced by urlVariables input in tool."),
+        method: z.string().describe("The request API method (GET, POST, PUT, DELETE, ...)"),
+        headers: z.record(z.string(), z.array(z.string())).optional().describe("The API header params"),
+        urlVariables: z.record(z.string(), z.any()).optional().describe("The API path variables"),
+        urlQueryParams: z.record(z.string(), z.string()).optional().describe("The API query parameters"),
+        requestBody: z.record(z.string(), z.any()).optional().describe("The API request body"),
+        specTitle: z.string().describe("The OpenAPI spec title from info.title"),
+        operationId: z.string().describe("The OpenAPI operationId"),
+    };
+}
+//# sourceMappingURL=openapi-service.js.map

package/dist/service/openapi-service.js.map

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

package/eslint.config.js

@@ -0,0 +1,58 @@
+import js from '@eslint/js';
+import typescript from '@typescript-eslint/eslint-plugin';
+import typescriptParser from '@typescript-eslint/parser';
+import globals from 'globals';
+
+export default [
+  // Base JavaScript recommended rules
+  js.configs.recommended,
+  
+  // Global ignores
+  {
+    ignores: ['dist/**', 'node_modules/**', 'coverage/**', '*.config.js', '*.config.ts', 'vitest.setup.ts'],
+  },
+  
+  // TypeScript configuration
+  {
+    files: ['**/*.ts', '**/*.tsx'],
+    languageOptions: {
+      parser: typescriptParser,
+      ecmaVersion: 'latest',
+      sourceType: 'module',
+      globals: {
+        ...globals.node,
+        ...globals.es2022,
+      },
+      parserOptions: {
+        project: ['./tsconfig.json', './tsconfig.node.json'],
+      },
+    },
+    plugins: {
+      '@typescript-eslint': typescript,
+    },
+    rules: {
+      // TypeScript rules
+      ...typescript.configs.recommended.rules,
+      '@typescript-eslint/explicit-function-return-type': 'off',
+      '@typescript-eslint/no-explicit-any': 'warn',
+      '@typescript-eslint/no-unused-vars': ['warn', { 
+        'argsIgnorePattern': '^_',
+        'varsIgnorePattern': '^_',
+        'caughtErrorsIgnorePattern': '^_',
+      }],
+      
+      // General rules
+      'semi': ['error', 'always'],
+      'quotes': ['warn', 'double'],
+      'no-console': 'off', // Since console.error is used for logging
+    },
+  },
+  
+  // Test files configuration
+  {
+    files: ['**/*.test.ts', '**/*.spec.ts'],
+    rules: {
+      'no-console': 'off',
+    },
+  },
+]; 

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "ebay-api-mcp-server-node-local",
+  "version": "1.0.0",
+  "description": "MCP server for eBay API with OpenAPI support",
+  "type": "module",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc --project tsconfig.build.json",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest run --coverage"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "openapi",
+    "ebay"
+  ],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "@apidevtools/swagger-parser": "^10.1.1",
+    "@modelcontextprotocol/sdk": "^1.11.1",
+    "axios": "^1.9.0",
+    "dotenv": "^16.5.0",
+    "js-yaml": "^4.1.0",
+    "openapi-types": "^12.1.3",
+    "tsx": "^4.20.3",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.30.1",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.15.17",
+    "@typescript-eslint/eslint-plugin": "^7.3.1",
+    "@typescript-eslint/parser": "^7.3.1",
+    "@vitest/coverage-v8": "^3.1.3",
+    "@vitest/ui": "^3.1.3",
+    "eslint": "^8.57.0",
+    "globals": "^16.3.0",
+    "typescript": "^5.3.3",
+    "vitest": "^3.1.3"
+  },
+  "packageManager": "yarn@3.6.1+sha512.de524adec81a6c3d7a26d936d439d2832e351cdfc5728f9d91f3fc85dd20b04391c038e9b4ecab11cae2b0dd9f0d55fd355af766bc5c1a7f8d25d96bb2a0b2ca"
+}