Compiler Explorer MCP

Instructions

NOTE: This may return a lot of results! Choose a specific regex to narrow down the results and not overflow the MCP client.

Args:
    compiler_regex: Regular expression to match compiler names (case-insensitive)

Returns:
    List of dictionaries containing matching compiler information, each with keys:
    - id: Unique identifier for the compiler
    - name: Display name of the compiler
    - semver: Version string of the compiler

Raises:
    HTTPException: If the API request fails

Example:
    >>> await list_compiler_versions("gcc")
    [{"id": "gcc-12.2", "name": "GCC 12.2"}, {"id": "gcc-11.3", "name": "GCC 11.3"}]

    >>> await list_compiler_versions("clang.*trunk")
    [..., {"id": "irclangtrunk", "name": "clang (trunk)", "lang": "llvm", "compilerType": "", "semver": "(trunk)", "instructionSet": "amd64"}, ...]

Implementation Reference

• server.py:309-340 (handler)

  The handler function decorated with @mcp.tool(), which implements the core logic of listing compiler versions matching the provided regex by querying ce_client and filtering results.

  @mcp.tool()
  async def list_compiler_versions(compiler_regex: str) -> list[dict[str, str]]:
      """Get available compiler versions matching a compiler name regex.
  
      NOTE: This may return a lot of results! Choose a specific regex to narrow down the results and not overflow the MCP client.
  
      Args:
          compiler_regex: Regular expression to match compiler names (case-insensitive)
  
      Returns:
          List of dictionaries containing matching compiler information, each with keys:
          - id: Unique identifier for the compiler
          - name: Display name of the compiler
          - semver: Version string of the compiler
  
      Raises:
          HTTPException: If the API request fails
  
      Example:
          >>> await list_compiler_versions("gcc")
          [{"id": "gcc-12.2", "name": "GCC 12.2"}, {"id": "gcc-11.3", "name": "GCC 11.3"}]
  
          >>> await list_compiler_versions("clang.*trunk")
          [..., {"id": "irclangtrunk", "name": "clang (trunk)", "lang": "llvm", "compilerType": "", "semver": "(trunk)", "instructionSet": "amd64"}, ...]
      """
      compilers = await ce_client.list_compilers()
      return [
          c
          for c in compilers
          if re.search(compiler_regex, c["name"], re.IGNORECASE)
          or re.search(compiler_regex, c["id"], re.IGNORECASE)
      ]