WordPress Trac MCP Server

Instructions

Implementation Reference

• src/index.ts:72-96 (registration)

  Registration of the 'getTicket' tool in the tools/list MCP method response, including its input schema definition.
  { name: "getTicket", description: "Get detailed information about a specific WordPress Trac ticket including description, comments, and metadata.", inputSchema: { type: "object", properties: { id: { type: "number", description: "Trac ticket ID number", }, includeComments: { type: "boolean", description: "Include ticket comments and discussion (default: true)", default: true, }, commentLimit: { type: "number", description: "Maximum number of comments to return (default: 10, max: 50)", default: 10, }, }, required: ["id"], }, }, {
• src/index.ts:379-519 (handler)

  Primary handler implementation for the 'getTicket' tool within the handleMcpRequest function's tools/call switch statement. Fetches ticket data using Trac's CSV query API, parses the response, extracts metadata, handles comments placeholder, and formats the output.
  case "getTicket": { const { id, includeComments = true } = args; try { // Use search approach since CSV parsing is problematic const searchUrl = new URL('https://core.trac.wordpress.org/query'); searchUrl.searchParams.set('format', 'csv'); searchUrl.searchParams.set('id', id.toString()); searchUrl.searchParams.set('max', '1'); const response = await fetch(searchUrl.toString(), { headers: { 'User-Agent': 'Mozilla/5.0 (compatible; WordPress-Trac-MCP-Server/1.0)', 'Accept': 'text/csv,text/plain,*/*', } }); if (!response.ok) { throw new Error(`HTTP ${response.status}: ${response.statusText}`); } const csvData = await response.text(); // Parse CSV data similar to searchTickets const lines = csvData.replace(/^\uFEFF/, '').trim().split(/\r?\n/); if (lines.length < 2) { throw new Error(`Ticket ${id} not found`); } // Parse each line like in searchTickets for (let i = 1; i < lines.length; i++) { const line = lines[i]?.trim(); if (!line) continue; // Better CSV parsing - handle quoted fields properly const values = []; let currentField = ''; let inQuotes = false; let escapeNext = false; for (let j = 0; j < line.length; j++) { const char = line[j]; if (escapeNext) { currentField += char; escapeNext = false; continue; } if (char === '\\') { escapeNext = true; continue; } if (char === '"') { if (inQuotes) { // Check if this is an escaped quote if (j + 1 < line.length && line[j + 1] === '"') { currentField += '"'; j++; // Skip the next quote } else { inQuotes = false; } } else { inQuotes = true; } } else if (char === ',' && !inQuotes) { values.push(currentField.trim()); currentField = ''; } else { currentField += char; } } values.push(currentField.trim()); if (values.length >= 2 && values[0] && !isNaN(parseInt(values[0]))) { const ticketId = parseInt(values[0]); if (ticketId === id) { // Map fields based on actual headers from search query // Headers: id,Summary,Owner,Type,Status,Priority,Milestone const ticket = { id: parseInt(values[0]), summary: values[1] || '', owner: values[2] || '', type: values[3] || '', status: values[4] || '', priority: values[5] || '', milestone: values[6] || '', reporter: '', // Not available in search query description: 'Full description not available in search query. Visit the ticket URL for complete details.', component: '', // Not available in search query version: '', severity: '', resolution: '', keywords: '', cc: '', focuses: '', }; // Note: Comments are not available through the CSV API let comments: any[] = []; if (includeComments) { comments = [{ author: 'system', timestamp: new Date().toISOString(), comment: 'Comment history not available through CSV API. Visit the ticket URL for full discussion.', }]; } result = { id: id, title: `#${id}: ${ticket.summary}`, text: `Ticket #${id}: ${ticket.summary}\n\nStatus: ${ticket.status}\nComponent: ${ticket.component}\nPriority: ${ticket.priority}\nType: ${ticket.type}\nReporter: ${ticket.reporter}\nOwner: ${ticket.owner}\nMilestone: ${ticket.milestone}\nVersion: ${ticket.version}\nKeywords: ${ticket.keywords}\n\nDescription:\n${ticket.description}\n\nFor full discussion and comments, visit: https://core.trac.wordpress.org/ticket/${id}`, url: `https://core.trac.wordpress.org/ticket/${id}`, metadata: { ticket, comments, totalComments: comments.length, }, }; break; // Found the ticket, exit the loop } } } // If we didn't find the ticket, result will be undefined if (!result) { throw new Error(`Ticket ${id} not found`); } } catch (error) { result = { id: id, title: `Error loading ticket ${id}`, text: `Error: ${error instanceof Error ? error.message : 'Unknown error'}`, url: `https://core.trac.wordpress.org/ticket/${id}`, metadata: { error: true }, }; } break; }
• src/index.ts:1160-1222 (helper)

  Helper function getTicketForChatGPT used in the ChatGPT-specific MCP handler for fetching and formatting ticket data, similar logic to main handler but simplified for ChatGPT's search/fetch tools.
  async function getTicketForChatGPT(ticketId: number, includeComments: boolean) { try { const searchUrl = new URL('https://core.trac.wordpress.org/query'); searchUrl.searchParams.set('format', 'csv'); searchUrl.searchParams.set('id', ticketId.toString()); searchUrl.searchParams.set('max', '1'); const response = await fetch(searchUrl.toString(), { headers: { 'User-Agent': 'Mozilla/5.0 (compatible; WordPress-Trac-MCP-Server/1.0)', 'Accept': 'text/csv,text/plain,*/*', } }); if (!response.ok) { throw new Error(`HTTP ${response.status}: ${response.statusText}`); } const csvData = await response.text(); const lines = csvData.replace(/^\uFEFF/, '').trim().split(/\r?\n/); if (lines.length < 2) { throw new Error(`Ticket ${ticketId} not found`); } const values = parseCSVLine(lines[1] || ''); if (values.length >= 2 && values[0] && parseInt(values[0]) === ticketId) { const ticket = { id: parseInt(values[0]), summary: values[1] || '', owner: values[2] || '', type: values[3] || '', status: values[4] || '', priority: values[5] || '', milestone: values[6] || '', }; // Cache the ticket chatgptCache.set(ticketId.toString(), ticket); const commentNote = includeComments ? "\n\nNote: Full comments and description available on the ticket page." : ""; return { id: ticketId.toString(), title: `#${ticketId}: ${ticket.summary}`, text: `Ticket #${ticketId}: ${ticket.summary}\n\nStatus: ${ticket.status}\nType: ${ticket.type}\nPriority: ${ticket.priority}\nOwner: ${ticket.owner}\nMilestone: ${ticket.milestone}${commentNote}`, url: `https://core.trac.wordpress.org/ticket/${ticketId}`, metadata: { ticket }, }; } else { throw new Error(`Ticket ${ticketId} not found`); } } catch (error) { return { id: ticketId.toString(), title: `Error loading ticket ${ticketId}`, text: `Error: ${error instanceof Error ? error.message : 'Unknown error'}`, url: `https://core.trac.wordpress.org/ticket/${ticketId}`, metadata: { error: true }, }; } }