generate_folder_map

Create or update a structured map file for any folder to document its contents and organization.

Instructions

Generate or update a _map.md file for a specific folder

Input Schema

TableJSON Schema

Name	Required	Description	Default
`folderPath`	Yes	Path to the folder to generate map for

Implementation Reference

src/index.ts:902-906 (handler)

MCP tool handler for 'generate_folder_map' that extracts folderPath argument and delegates to FolderMapper.generateFolderMap

case 'generate_folder_map': {
  const folderPath = args.folderPath as string;
  const folderMap = await this.folderMapper.generateFolderMap(folderPath);
  return { content: [{ type: 'text', text: `Folder map generated successfully for: ${folderPath}` }] };
}

src/index.ts:726-735 (registration)

Registration of the 'generate_folder_map' tool including name, description, and input schema in the MCP server's tools list

  name: 'generate_folder_map',
  description: 'Generate or update a _map.md file for a specific folder',
  inputSchema: {
    type: 'object',
    properties: {
      folderPath: { type: 'string', description: 'Path to the folder to generate map for' }
    },
    required: ['folderPath']
  }
},

src/index.ts:728-734 (schema)

Input schema definition for the generate_folder_map tool: requires folderPath string

inputSchema: {
  type: 'object',
  properties: {
    folderPath: { type: 'string', description: 'Path to the folder to generate map for' }
  },
  required: ['folderPath']
}

src/folder-mapper.ts:116-149 (helper)

Main implementation logic for generating folder maps: scans files in folder, analyzes exports/imports using TypeScript parser, builds FolderMap object, generates and writes _map.md file

async generateFolderMap(folderPath: string): Promise<FolderMap> {
  const folderName = path.basename(folderPath);
  console.log(chalk.blue(`📁 Generating map for: ${folderName}`));

  const files = await this.getFilesInFolder(folderPath);
  const fileInfos: FileInfo[] = [];

  for (const file of files) {
    try {
      const fileInfo = await this.analyzeFile(file);
      if (fileInfo.exports.length > 0) {
        fileInfos.push(fileInfo);
      }
    } catch (error) {
      console.log(chalk.yellow(`⚠️  Could not analyze ${file}: ${error}`));
    }
  }

  const folderMap: FolderMap = {
    folderPath,
    folderName,
    purpose: this.inferFolderPurpose(folderName, fileInfos),
    files: fileInfos,
    dependencies: this.extractUniqueDependencies(fileInfos),
    tests: await this.findRelatedTests(folderPath),
    lastGenerated: new Date().toISOString(),
    totalClasses: this.countByType(fileInfos, 'class'),
    totalInterfaces: this.countByType(fileInfos, 'interface'),
    totalFunctions: this.countByType(fileInfos, 'function')
  };

  await this.writeMapFile(folderPath, folderMap);
  return folderMap;
}

MCP Memory Server