WordPress Trac MCP Server

Instructions

Implementation Reference

• src/index.ts:140-153 (registration)

  Registration of the getTracInfo tool in the tools/list response, including name, description, and input schema.

    name: "getTracInfo",
    description: "Get WordPress Trac metadata like components, milestones, priorities, and severities.",
    inputSchema: {
      type: "object",
      properties: {
        type: {
          type: "string",
          enum: ["components", "milestones", "priorities", "severities"],
          description: "Type of Trac information to retrieve",
        },
      },
      required: ["type"],
    },
  },

• src/index.ts:142-152 (schema)

  Input schema definition for getTracInfo tool.

  inputSchema: {
    type: "object",
    properties: {
      type: {
        type: "string",
        enum: ["components", "milestones", "priorities", "severities"],
        description: "Type of Trac information to retrieve",
      },
    },
    required: ["type"],
  },

• src/index.ts:701-834 (handler)

  Core handler implementation for the getTracInfo tool. Queries the Trac ticket list in CSV format, parses columns based on the requested type (milestones, priorities, types, statuses), collects unique values, sorts them, and returns a formatted result with metadata. Handles unsupported types like components and severities with appropriate errors.

  case "getTracInfo": {
    const { type } = args;
    
    try {
      let data: any = {};
      let uniqueValues = new Set<string>();
      
      // Get a sample of tickets to extract unique values for the requested field
      const queryUrl = new URL('https://core.trac.wordpress.org/query');
      queryUrl.searchParams.set('format', 'csv');
      queryUrl.searchParams.set('max', '1000'); // Get more tickets for better coverage
      
      const response = await fetch(queryUrl.toString(), {
        headers: {
          'User-Agent': 'Mozilla/5.0 (compatible; WordPress-Trac-MCP-Server/1.0)',
          'Accept': 'text/csv,text/plain,*/*',
          'Accept-Language': 'en-US,en;q=0.9',
        }
      });
      
      if (!response.ok) {
        throw new Error(`HTTP ${response.status}: ${response.statusText}`);
      }
      
      const csvData = await response.text();
      
      // Parse CSV data
      const lines = csvData.replace(/^\uFEFF/, '').trim().split('\n');
      const headers = (lines[0] || '').split(',').map(h => h.replace(/"/g, '').trim());
      
      // Find the column index for the requested type
      let columnIndex = -1;
      switch (type) {
        case "components":
          // Components are not in the default query, need different approach
          throw new Error(`Components list not available in default query. Try using the search function instead.`);
        case "milestones":
          columnIndex = headers.indexOf('Milestone');
          break;
        case "priorities":
          columnIndex = headers.indexOf('Priority');
          break;
        case "severities":
          // Severities are not in the default query
          throw new Error(`Severities list not available in default query. Try using the search function instead.`);
        case "types":
          columnIndex = headers.indexOf('Type');
          break;
        case "statuses":
          columnIndex = headers.indexOf('Status');
          break;
        default:
          throw new Error(`Unknown info type: ${type}. Available types: milestones, priorities, types, statuses`);
      }
      
      if (columnIndex === -1) {
        throw new Error(`Column not found for type: ${type}. Available columns: ${headers.join(', ')}`);
      }
      
      // Extract unique values using better CSV parsing
      for (let i = 1; i < lines.length && lines[i]; 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[columnIndex]?.trim()) {
          uniqueValues.add(values[columnIndex]?.trim() || '');
        }
      }
      
      data = Array.from(uniqueValues).sort();
  
      result = {
        id: type,
        title: `WordPress Trac ${type}`,
        text: `${type.charAt(0).toUpperCase() + type.slice(1)} available in WordPress Trac:\n\n${data.join('\n')}`,
        url: 'https://core.trac.wordpress.org/',
        metadata: {
          type,
          data,
          total: data.length,
        },
      };
    } catch (error) {
      result = {
        id: type,
        title: `Error loading ${type}`,
        text: `Error: ${error instanceof Error ? error.message : 'Unknown error'}. Available types: components, milestones, priorities, severities, types, statuses`,
        url: 'https://core.trac.wordpress.org/',
        metadata: { error: true },
      };
    }
    break;
  }