Function registerCompileTool

lib/mcp/tools/compile.ts:39–278

(server: McpServer, compileHandler: CompileHandler, apiHandler: ApiHandler)

const DEFAULT_MAX_STDERR_LINES = 100;

export function registerCompileTool(server: McpServer, compileHandler: CompileHandler, apiHandler: ApiHandler): void {
    server.tool(
        'compile',
        'Compile source code and return assembly output, stdout, and stderr',
        {
            source: z.string().describe('Source code to compile'),
            language: z.string().describe('Language ID (e.g. "c++", "c", "rust", "python")'),
            compiler: z
                .string()
                .optional()
                .describe(
                    'Compiler ID from list_compilers (e.g. "g161"). If omitted, uses the language\'s ' +
                        '`defaultCompiler` from list_languages.',
                ),
            options: z.string().optional().describe('Compiler flags (e.g. "-O2 -std=c++20 -Wall")'),
            execute: z
                .boolean()
                .optional()
                .describe(
                    'Run the program instead of returning assembly. `asm` becomes empty; runtime output goes to ' +
                        'top-level `stdout`/`stderr`; compile diagnostics move to `buildResult.stdout`/`stderr`.',
                ),
            stdin: z.string().optional().describe('Standard input for execution (requires execute=true)'),
            filters: z
                .object({
                    intel: z.boolean().optional().describe('Use Intel assembly syntax (default: true)'),
                    demangle: z.boolean().optional().describe('Demangle symbol names (default: true)'),
                    directives: z.boolean().optional().describe('Filter assembler directives (default: true)'),
                    commentOnly: z.boolean().optional().describe('Filter comment-only lines (default: true)'),
                    labels: z.boolean().optional().describe('Filter unused labels (default: true)'),
                    libraryCode: z.boolean().optional().describe('Filter library code (default: false)'),
                    trim: z.boolean().optional().describe('Trim whitespace (default: false)'),
                })
                .optional()
                .describe('Output filters'),
            libraries: z
                .array(
                    z.object({
                        id: z.string().describe('Library ID from list_libraries (e.g. "boost").'),
                        version: z.string().describe('Version id ("188") OR human form ("1.88.0") — both accepted.'),
                    }),
                )
                .optional()
                .describe('Libraries to link.'),
            maxAsmLines: z
                .number()
                .int()
                .positive()
                .optional()
                .describe(`Cap asm output (default ${DEFAULT_MAX_ASM_LINES} lines).`),
            maxStdoutLines: z
                .number()
                .int()
                .positive()
                .optional()
                .describe(
                    `Cap each stdout stream — compile and execute separately (default ${DEFAULT_MAX_STDOUT_LINES}).`,
                ),