@mikevalstar/mcp-cookbook/build/lib/recipeList.js

MCP server providing AI coding assistants with reusable recipes and procedures for common development tasks

import fg from "fast-glob";
import path from "path";
import fs from "fs/promises";
import matter from "gray-matter";
import Fuse from "fuse.js";
import chalk from "chalk";
/**
 * Retrieves a list of recipes from markdown files in .cookbook directories
 *
 * This function scans for markdown files within .cookbook directories,
 * extracts frontmatter data, and optionally filters results using fuzzy search.
 *
 * @param folder - The root folder path to search for .cookbook directories
 * @param search - Optional search term to filter recipes using fuzzy search
 * @returns Promise that resolves to an array of recipe objects
 *
 * @example
 * ```typescript
 * // Get all recipes
 * const allRecipes = await recipeList('/path/to/project');
 *
 * // Search for specific recipes
 * const searchResults = await recipeList('/path/to/project', 'docker');
 * ```
 */
export async function recipeList(folder, search) {
    // Find all markdown files in .cookbook directories
    let files = [];
    try {
        files = await fg(path.join(folder, "**/.cookbook/**/*.md"));
    }
    catch (error) {
        console.error(chalk.red(`Error scanning for recipe files in ${folder}:`), error);
        return [];
    }
    // loop over files and read the file's frontmatter into memory
    const recipes = files.map(async (file) => {
        try {
            const content = await fs.readFile(file, "utf8");
            const frontmatter = matter(content);
            return {
                fm: frontmatter,
                fileName: file,
            };
        }
        catch (error) {
            console.error(chalk.yellow(`Warning: Could not read recipe file ${file}:`), error);
            return null; // Return null for failed reads
        }
    });
    const recipesAwaited = await Promise.all(recipes);
    // Filter out null values (failed reads) and transform into recipe objects
    const returnData = recipesAwaited
        .filter((recipe) => recipe !== null)
        .map((recipe) => {
        return {
            filename: recipe.fileName,
            name: recipe.fm.data.name || "",
            description: recipe.fm.data.description || "",
            short: recipe.fm.data.short || "",
        };
    });
    // Apply fuzzy search if search term provided
    if (search) {
        const fuse = new Fuse(returnData, {
            keys: ["name", "short", "description", "filename"],
            distance: 1000,
            threshold: 0.5,
        });
        return fuse
            .search(search)
            .map((result) => result.item)
            .slice(0, 50);
    }
    return returnData;
}