Fragment MCP Server

Instructions

Implementation Reference

• main.ts:24-61 (handler)

  The main tool handler function for 'convert-ifc-to-frag', which performs file existence checks, invokes the core conversion function, and formats the response.

  async ({ inputPath, outputPath }) => {
    if (!fs.existsSync(inputPath)) {
      return {
        content: [
          {
            type: 'text',
            text: 'IFC file not found. Please provide a valid .ifc file path.',
          },
        ],
      }
    }
  
    if (fs.existsSync(outputPath)) {
      return {
        content: [
          {
            type: 'text',
            text: 'Output .frag file already exists. Please call load-frag directly',
          },
        ],
      }
    }
  
   const model = await convertIfcToFragment(inputPath, outputPath)
  
    return {
      content: [
        {
          type: 'text',
          text: `Converted IFC file to .frag format. Output saved to ${outputPath}. Model contains ${
            model.getItemsWithGeometry().length
          } items with geometry: ${JSON.stringify(
            fetchCategoriesWithGeometry(fragments)
          )}`,
        },
      ],
    }
  }

• main.ts:18-23 (schema)

  Zod schema defining the input parameters for the tool: inputPath and outputPath.

  {
    inputPath: z.string().describe('Full path of the IFC file to convert'),
    outputPath: z
      .string()
      .describe('Full path where the output .frags file will be saved'),
  },

• main.ts:15-62 (registration)

  Registers the 'convert-ifc-to-frag' tool with MCP server, specifying name, description, schema, and handler.

  server.tool(
    'convert-ifc-to-frag',
    'Convert an IFC file to a .frag file. Needs file-system server',
    {
      inputPath: z.string().describe('Full path of the IFC file to convert'),
      outputPath: z
        .string()
        .describe('Full path where the output .frags file will be saved'),
    },
    async ({ inputPath, outputPath }) => {
      if (!fs.existsSync(inputPath)) {
        return {
          content: [
            {
              type: 'text',
              text: 'IFC file not found. Please provide a valid .ifc file path.',
            },
          ],
        }
      }
  
      if (fs.existsSync(outputPath)) {
        return {
          content: [
            {
              type: 'text',
              text: 'Output .frag file already exists. Please call load-frag directly',
            },
          ],
        }
      }
  
     const model = await convertIfcToFragment(inputPath, outputPath)
  
      return {
        content: [
          {
            type: 'text',
            text: `Converted IFC file to .frag format. Output saved to ${outputPath}. Model contains ${
              model.getItemsWithGeometry().length
            } items with geometry: ${JSON.stringify(
              fetchCategoriesWithGeometry(fragments)
            )}`,
          },
        ],
      }
    }
  )

• fragments.ts:5-22 (helper)

  Core helper function that performs the actual IFC to .frag conversion using FRAGS.IfcImporter and saves the output file.

  export const convertIfcToFragment = async (
    inputPath: string,
    outputPath: string
  ) => {
    const ifcFile = await fs.promises.readFile(inputPath)
    const typedArray = new Uint8Array(ifcFile)
    const serializer = new FRAGS.IfcImporter()
    serializer.wasm = {
      path: '/',
      absolute: false,
    }
    const bytes = await serializer.process({ bytes: typedArray, raw: false })
    const model = new FRAGS.SingleThreadedFragmentsModel('model', bytes)
  
    await fs.promises.writeFile(outputPath, bytes)
  
    return model
  }