MCP OpenAPI Server

Instructions

Implementation Reference

• src/McpService.ts:48-60 (handler)

  Inline handler for the refresh-api-catalog tool. Logs the action, calls specExplorer.refresh() to refresh the API catalog, and returns a success message. Errors are logged and rethrown.

  server.tool("refresh-api-catalog", "Refresh the API catalog", async () => {
    try {
      this.logger.info('Refreshing API catalog');
      await this.specExplorer.refresh();
      this.logger.info('API catalog refreshed successfully');
      return {
        content: [{ type: "text", text: "API catalog refreshed" }],
      };
    } catch (error) {
      this.logger.error('Failed to refresh API catalog', { error });
      throw error;
    }
  });

• src/McpService.ts:48-60 (registration)

  Registers the refresh-api-catalog tool on the MCP server with no input schema and the inline handler function.

  server.tool("refresh-api-catalog", "Refresh the API catalog", async () => {
    try {
      this.logger.info('Refreshing API catalog');
      await this.specExplorer.refresh();
      this.logger.info('API catalog refreshed successfully');
      return {
        content: [{ type: "text", text: "API catalog refreshed" }],
      };
    } catch (error) {
      this.logger.error('Failed to refresh API catalog', { error });
      throw error;
    }
  });