PrimeNG MCP Server

Instructions

Implementation Reference

• src/tools/GetGuideTool.ts:28-50 (handler)

  The execute method in GetGuideTool implements the core logic for the get_tailwind_guide tool: checks cache, scrapes the 'tailwind' guide if needed, caches the result, formats it, and returns the response. This is called via run() from BaseTool.
  async execute(_args: Record<string, any>): Promise<ToolResponse> { try { // Check cache first const cachedGuide = await this.cacheService.getGuide(this.guideName); if (cachedGuide) { logger.info(`Returning cached guide: ${this.guideName}`); return this.createResponse(formatGuideDoc(cachedGuide)); } // Scrape guide const guide = await this.scraperService.scrapeGuide(this.guideName); // Cache the result await this.cacheService.setGuide(this.guideName, guide); return this.createResponse(formatGuideDoc(guide)); } catch (error) { const errorMessage = error instanceof Error ? error.message : String(error); return this.createErrorResponse( `Failed to get ${this.guideName} guide: ${errorMessage}` ); } }
• src/models/ToolSchemas.ts:153-162 (schema)

  Defines the MCP tool schema for 'get_tailwind_guide', including name, description, and empty input schema (no parameters required).
  export function createGetTailwindGuideSchema(): Tool { return { name: "get_tailwind_guide", description: "Obtiene la guía de integración de PrimeNG con Tailwind CSS", inputSchema: { type: "object", properties: {}, }, }; }
• src/server/PrimeNGServer.ts:230-231 (registration)

  Tool dispatch registration in the MCP CallToolRequest handler: calls getTailwindGuideTool.run() when 'get_tailwind_guide' is requested.
  case "get_tailwind_guide": return await this.getTailwindGuideTool.run(args);
• src/server/PrimeNGServer.ts:166-169 (registration)

  Instantiation and registration of the GetTailwindGuideTool instance in PrimeNGServer during initialization.
  this.getTailwindGuideTool = new GetTailwindGuideTool( this.docsScraperService, this.cacheService );
• src/tools/GetTailwindGuideTool.ts:9-12 (helper)

  Specific tool class for 'get_tailwind_guide' that extends GetGuideTool, configuring it with tool name and 'tailwind' guide name.
  export class GetTailwindGuideTool extends GetGuideTool { constructor(scraperService: DocsScraperService, cacheService: CacheService) { super('get_tailwind_guide', 'tailwind', scraperService, cacheService); }