Function registerCompilersTool

lib/mcp/tools/compilers.ts:109–209

(server: McpServer, apiHandler: ApiHandler)

}

export function registerCompilersTool(server: McpServer, apiHandler: ApiHandler): void {
    server.tool(
        'list_compilers',
        'List available compilers, optionally filtered by language',
        {
            language: z.string().optional().describe('Language ID to filter by (e.g. "c++", "rust", "python")'),
            instructionSet: z
                .enum(InstructionSetsList)
                .optional()
                .describe(
                    'Target architecture filter. Combine with `latestPerMajor: true` for "newest X for arch Y" ' +
                        '(e.g. `{language:"c++", instructionSet:"amd64", latestPerMajor:true}`).',
                ),
            match: z
                .string()
                .optional()
                .describe(
                    'Case-insensitive AND-of-tokens filter on id and name. Punctuation splits tokens; numeric ' +
                        'tokens match whole-word ("gcc 14.1" matches "14.1.0" not "14.10"); alphanumeric tokens ' +
                        'substring-match ("g14" matches "g142"). Literal text only — for "newest version" use ' +
                        '`latestPerMajor`; for "newest X on arch Y" prefer `instructionSet` + `latestPerMajor`.',
                ),
            maxResults: z
                .number()
                .int()
                .positive()
                .optional()
                .describe(
                    `Cap full-detail entries (default ${DEFAULT_MAX_RESULTS}). Beyond the cap, degrades to lean ` +
                        '(id+name only) with a refinement hint.',
                ),
            lean: z
                .boolean()
                .optional()
                .describe('Force id+name only, regardless of count. Useful to browse the catalog before drilling in.'),
            latestPerMajor: z
                .boolean()
                .optional()
                .describe(
                    `"Newest X" filter. By release track (${RELEASE_TRACKS.join('/')}): newest stable per ` +
                        '(language, instructionSet, semver major); all nightly + prerelease; experimental ' +
                        'skipped unless `includeExperimental: true`.',
                ),
            includeExperimental: z
                .boolean()
                .optional()
                .describe(
                    'With `latestPerMajor: true`, also include experimental compilers (c++ proposal forks, ' +
                        'llvm-mos platform variants). Off by default — bloats "newest X" answers.',
                ),
        },
        {
            title: 'List compilers',
            readOnlyHint: true,
            openWorldHint: false,
        },
        async ({language, instructionSet, match, maxResults, lean, latestPerMajor, includeExperimental}) => {
            let pool = apiHandler.compilers;