trace_file
Analyze TypeScript files to detect schema mismatches between data producers and consumers through static analysis, enabling automated validation and code generation.
Instructions
Trace MCP tool usage in a single TypeScript file.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| filePath | Yes | Path to a TypeScript file |
Implementation Reference
- src/index.ts:357-375 (handler)Handler for 'trace_file' tool: parses input, calls traceFromFile, and returns JSON resultcase 'trace_file': { const input = TraceFileInput.parse(args); log(`Tracing file: ${input.filePath}`); const usage = await traceFromFile(input.filePath); return { content: [ { type: 'text', text: JSON.stringify({ success: true, count: usage.length, usage, }, null, 2), }, ], }; }
- src/index.ts:69-71 (schema)Zod input schema for trace_file tool: requires filePathconst TraceFileInput = z.object({ filePath: z.string().describe('Path to a single TypeScript file to trace tool usage in'), });
- src/index.ts:167-177 (registration)Registration of trace_file tool in ListToolsResponse{ name: 'trace_file', description: 'Trace MCP tool usage in a single TypeScript file.', inputSchema: { type: 'object', properties: { filePath: { type: 'string', description: 'Path to a TypeScript file' }, }, required: ['filePath'], }, },
- src/trace/index.ts:53-75 (helper)Core helper function traceFromFile: delegates to language parser's traceUsage method for the specific fileexport async function traceFromFile(filePath: string, language?: string): Promise<ConsumerSchema[]> { // For backward compatibility, default to TypeScript const lang = language || 'typescript'; if (!hasParser(lang)) { throw new Error( `No parser available for language: ${lang}. Make sure to call bootstrapLanguageParsers() at startup.` ); } const parser = getParser(lang); // Extract from the directory containing the file const rootDir = filePath.substring(0, filePath.lastIndexOf('/') || filePath.lastIndexOf('\\')); const fileName = filePath.substring((filePath.lastIndexOf('/') || filePath.lastIndexOf('\\')) + 1); const allSchemas = await parser.traceUsage({ rootDir: rootDir || '.', include: [fileName], }); return allSchemas.filter(s => s.callSite.file === filePath); }