Specialized AI Search Tools

Instructions

Implementation Reference

• src/tools/index.ts:17-31 (registration)

  Registration function that instantiates the TypeConversionTool and registers it along with other tools to the MCP server using server.registerTools
  export function registerAllTools(server: MCPServer): void { const tools: BaseTool[] = [ new WebSearchTool(), new WebFetchTool(), new TypeConversionTool(), ]; // Register all tools if (tools.length > 0) { server.registerTools(tools); logger.info(`Registered ${tools.length} tool(s): ${tools.map(t => t.name).join(', ')}`); } else { logger.warn('No tools registered - add tool implementations to src/tools/index.ts'); } }
• src/tools/conversion.ts:13-39 (schema)

  Zod schemas defining supported formats, conversion options, input parameters (TypeConversionParams) for the typeconversion tool
  const formatEnum = z.enum(['json', 'xml', 'yaml', 'csv', 'toml']); type DataFormat = z.infer<typeof formatEnum>; /** * Conversion options schema */ const conversionOptionsSchema = z .object({ pretty: z.boolean().optional().default(true).describe('Pretty print output (with indentation)'), indent: z.number().int().min(0).max(8).optional().default(2).describe('Indentation spaces for pretty printing'), csvDelimiter: z.string().optional().default(',').describe('CSV delimiter character'), csvHeaders: z.boolean().optional().default(true).describe('CSV has headers in first row'), }) .optional(); /** * Type conversion tool schema */ const typeConversionSchema = z.object({ input: z.string().min(1).describe('Input data as string'), fromFormat: formatEnum.describe('Source data format'), toFormat: formatEnum.describe('Target data format'), options: conversionOptionsSchema, }); type TypeConversionParams = z.infer<typeof typeConversionSchema>;
• src/tools/conversion.ts:43-66 (handler)

  TypeConversionTool class with name, description, schema reference, and execute handler method that orchestrates parsing input to JS object and formatting to target output using private helpers
  export class TypeConversionTool extends BaseTool<typeof typeConversionSchema> { readonly name = 'typeconversion'; readonly description = 'Convert data between different formats: JSON, XML, YAML, CSV, and TOML. Supports pretty printing, minification, and format-specific options like CSV delimiters and headers.'; readonly schema = typeConversionSchema; protected async execute(params: TypeConversionParams): Promise<string> { logger.info(`Converting from ${params.fromFormat} to ${params.toFormat}`); try { // Parse input to intermediate format (JavaScript object) const data = await this.parseInput(params.input, params.fromFormat, params.options); // Convert to target format const output = await this.formatOutput(data, params.toFormat, params.options); logger.info(`Conversion completed successfully`); return output; } catch (error) { throw new Error( `Conversion failed: ${error instanceof Error ? error.message : 'Unknown error'}` ); } }
• src/tools/conversion.ts:71-90 (helper)

  parseInput helper: dispatches input parsing based on fromFormat to specific parser methods
  private async parseInput( input: string, format: DataFormat, options?: z.infer<typeof conversionOptionsSchema> ): Promise<any> { switch (format) { case 'json': return this.parseJson(input); case 'xml': return await this.parseXmlToObject(input); case 'yaml': return this.parseYaml(input); case 'csv': return this.parseCsvToObject(input, options); case 'toml': return this.parseToml(input); default: throw new Error(`Unsupported input format: ${format}`); } }
• src/tools/conversion.ts:95-114 (helper)

  formatOutput helper: dispatches object formatting based on toFormat to specific formatter methods
  private async formatOutput( data: any, format: DataFormat, options?: z.infer<typeof conversionOptionsSchema> ): Promise<string> { switch (format) { case 'json': return this.formatJson(data, options); case 'xml': return await this.formatXml(data, options); case 'yaml': return this.formatYaml(data, options); case 'csv': return this.formatCsv(data, options); case 'toml': return this.formatToml(data); default: throw new Error(`Unsupported output format: ${format}`); } }