Codex MCP Server

Instructions

Implementation Reference

• src/tools/timeout-test.tool.ts:16-37 (handler)

  The main handler function that executes the timeout test by sleeping for the specified duration in steps, reporting progress, and returning a summary of the execution.

  execute: async (args, onProgress) => {
    const duration = args.duration as number;
    const steps = Math.ceil(duration / 5000); // Progress every 5 seconds
    const stepDuration = duration / steps;
    const startTime = Date.now();
  
    const results: string[] = [];
    results.push(`Starting timeout test for ${duration}ms (${duration / 1000}s)`);
  
    for (let i = 1; i <= steps; i++) {
      await new Promise(resolve => setTimeout(resolve, stepDuration));
      const elapsed = Date.now() - startTime;
      results.push(`Step ${i}/${steps} completed - Elapsed: ${Math.round(elapsed / 1000)}s`);
    }
  
    const totalElapsed = Date.now() - startTime;
    results.push(`\nTimeout test completed successfully!`);
    results.push(`Target duration: ${duration}ms`);
    results.push(`Actual duration: ${totalElapsed}ms`);
  
    return results.join('\n');
  },

• src/tools/timeout-test.tool.ts:4-6 (schema)

  Zod schema defining the input parameter 'duration' as a number with minimum 10ms.

  const timeoutTestArgsSchema = z.object({
    duration: z.number().min(10).describe('Duration in milliseconds (minimum 10ms)'),
  });

• src/tools/index.ts:11-21 (registration)

  Registration of the timeoutTestTool into the central toolRegistry along with other tools.

  toolRegistry.push(
    askCodexTool,
    batchCodexTool,
    // reviewCodexTool,
    pingTool,
    helpTool,
    versionTool,
    brainstormTool,
    fetchChunkTool,
    timeoutTestTool
  );