extract_file
Extract MCP tool definitions from TypeScript files to validate contracts and prevent runtime errors in data producer-consumer interactions.
Instructions
Extract MCP tool definitions from a single TypeScript file.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| filePath | Yes | Path to a TypeScript file |
Implementation Reference
- src/index.ts:311-329 (handler)Handles the 'extract_file' MCP tool call: parses input, invokes extractFromFile, and formats response with extracted schemas.
case 'extract_file': { const input = ExtractFileInput.parse(args); log(`Extracting from file: ${input.filePath}`); const schemas = await extractFromFile(input.filePath); return { content: [ { type: 'text', text: JSON.stringify({ success: true, count: schemas.length, schemas, }, null, 2), }, ], }; } - src/index.ts:65-67 (schema)Zod schema defining input validation for the extract_file tool (filePath parameter).
const ExtractFileInput = z.object({ filePath: z.string().describe('Path to a single TypeScript file to extract schemas from'), }); - src/index.ts:143-153 (registration)Registers the extract_file tool in the MCP server's listTools response, providing name, description, and JSON schema.
{ name: 'extract_file', description: 'Extract MCP tool definitions from a single TypeScript file.', inputSchema: { type: 'object', properties: { filePath: { type: 'string', description: 'Path to a TypeScript file' }, }, required: ['filePath'], }, }, - src/extract/index.ts:50-72 (helper)Implements extractFromFile: determines language parser, extracts schemas from the target file by including only that file, and filters results.
export async function extractFromFile(filePath: string, language?: string): Promise<ProducerSchema[]> { // 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.extractSchemas({ rootDir: rootDir || '.', include: [fileName], }); return allSchemas.filter(s => s.location.file === filePath); }