RAG Documentation MCP Server

Instructions

Implementation Reference

• src/tools/clear-queue.ts:25-67 (handler)

  The core handler logic that implements the clear_queue tool. It checks if the queue file exists, reads the current content to count URLs, empties the file to clear the queue, and returns a success message with the count or handles errors.
  async execute(_args: any): Promise<McpToolResponse> { try { // Check if queue file exists try { await fs.access(QUEUE_FILE); } catch { return { content: [ { type: 'text', text: 'Queue is already empty (queue file does not exist)', }, ], }; } // Read current queue to get count of URLs being cleared const content = await fs.readFile(QUEUE_FILE, 'utf-8'); const urlCount = content.split('\n').filter(url => url.trim() !== '').length; // Clear the queue by emptying the file await fs.writeFile(QUEUE_FILE, ''); return { content: [ { type: 'text', text: `Queue cleared successfully. Removed ${urlCount} URL${urlCount === 1 ? '' : 's'} from the queue.`, }, ], }; } catch (error) { return { content: [ { type: 'text', text: `Failed to clear queue: ${error}`, }, ], isError: true, }; } }
• src/tools/clear-queue.ts:13-23 (schema)

  The tool schema definition including name, description, and empty input schema (no parameters required).
  get definition(): ToolDefinition { return { name: 'clear_queue', description: 'Clear all URLs from the queue', inputSchema: { type: 'object', properties: {}, required: [], }, }; }
• src/handler-registry.ts:44-44 (registration)

  Registers the ClearQueueHandler instance for the 'clear_queue' tool in the handlers map.
  this.handlers.set('clear_queue', new ClearQueueHandler(this.server, this.apiClient));
• src/handler-registry.ts:131-137 (registration)

  Registers the tool schema in the ListTools response, duplicating the definition for tool discovery.
  name: 'clear_queue', description: 'Remove all pending URLs from the documentation processing queue. Use this to reset the queue when you want to start fresh, remove unwanted URLs, or cancel pending processing. This operation is immediate and permanent - URLs will need to be re-added if you want to process them later. Returns the number of URLs that were cleared from the queue.', inputSchema: { type: 'object', properties: {}, }, } as ToolDefinition,
• src/handlers/clear-queue.ts:5-13 (handler)

  The ClearQueueHandler class that extends the tool and delegates handle() to execute(), serving as the MCP request handler entry point.
  export class ClearQueueHandler extends ClearQueueTool { constructor(server: Server, apiClient: ApiClient) { super(); } async handle(args: any) { return this.execute(args); } }