mcp_howtocook_getRecipeById
Retrieve complete recipe details including ingredients and cooking steps by entering a recipe name or ID. Use this tool to access specific cooking instructions from a Chinese recipe database.
Instructions
根据菜谱名称或ID查询指定菜谱的完整详情，包括食材、步骤等
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | 菜谱名称或ID，支持模糊匹配菜谱名称 |
Implementation Reference
- src/tools/getRecipeById.ts:12-78 (handler)Async handler function that implements the core logic: searches recipes by exact ID, exact name, fuzzy name match, or provides up to 5 possible matches based on name/description, returning formatted JSON text content.
async ({ query }: { query: string }) => { // 首先尝试精确匹配ID let foundRecipe = recipes.find(recipe => recipe.id === query); // 如果没有找到，尝试精确匹配名称 if (!foundRecipe) { foundRecipe = recipes.find(recipe => recipe.name === query); } // 如果还没有找到，尝试模糊匹配名称 if (!foundRecipe) { foundRecipe = recipes.find(recipe => recipe.name.toLowerCase().includes(query.toLowerCase()) ); } // 如果仍然没有找到，返回所有可能的匹配项（最多5个） if (!foundRecipe) { const possibleMatches = recipes.filter(recipe => recipe.name.toLowerCase().includes(query.toLowerCase()) || recipe.description.toLowerCase().includes(query.toLowerCase()) ).slice(0, 5); if (possibleMatches.length === 0) { return { content: [ { type: "text", text: JSON.stringify({ error: "未找到匹配的菜谱", query: query, suggestion: "请检查菜谱名称是否正确，或尝试使用关键词搜索" }, null, 2), }, ], }; } return { content: [ { type: "text", text: JSON.stringify({ message: "未找到精确匹配，以下是可能的匹配项：", query: query, possibleMatches: possibleMatches.map(recipe => ({ id: recipe.id, name: recipe.name, description: recipe.description, category: recipe.category })) }, null, 2), }, ], }; } // 返回找到的完整菜谱信息 return { content: [ { type: "text", text: JSON.stringify(foundRecipe, null, 2), }, ], }; } - src/tools/getRecipeById.ts:9-11 (schema)Zod input schema defining a single 'query' string parameter with description for recipe name or ID supporting fuzzy matching.
{ query: z.string().describe('菜谱名称或ID，支持模糊匹配菜谱名称') }, - src/tools/getRecipeById.ts:5-80 (registration)registerGetRecipeByIdTool function that registers the tool on the McpServer instance using server.tool() with name, description, schema, and handler, requiring a recipes array.
export function registerGetRecipeByIdTool(server: McpServer, recipes: Recipe[]) { server.tool( "mcp_howtocook_getRecipeById", "根据菜谱名称或ID查询指定菜谱的完整详情，包括食材、步骤等", { query: z.string().describe('菜谱名称或ID，支持模糊匹配菜谱名称') }, async ({ query }: { query: string }) => { // 首先尝试精确匹配ID let foundRecipe = recipes.find(recipe => recipe.id === query); // 如果没有找到，尝试精确匹配名称 if (!foundRecipe) { foundRecipe = recipes.find(recipe => recipe.name === query); } // 如果还没有找到，尝试模糊匹配名称 if (!foundRecipe) { foundRecipe = recipes.find(recipe => recipe.name.toLowerCase().includes(query.toLowerCase()) ); } // 如果仍然没有找到，返回所有可能的匹配项（最多5个） if (!foundRecipe) { const possibleMatches = recipes.filter(recipe => recipe.name.toLowerCase().includes(query.toLowerCase()) || recipe.description.toLowerCase().includes(query.toLowerCase()) ).slice(0, 5); if (possibleMatches.length === 0) { return { content: [ { type: "text", text: JSON.stringify({ error: "未找到匹配的菜谱", query: query, suggestion: "请检查菜谱名称是否正确，或尝试使用关键词搜索" }, null, 2), }, ], }; } return { content: [ { type: "text", text: JSON.stringify({ message: "未找到精确匹配，以下是可能的匹配项：", query: query, possibleMatches: possibleMatches.map(recipe => ({ id: recipe.id, name: recipe.name, description: recipe.description, category: recipe.category })) }, null, 2), }, ], }; } // 返回找到的完整菜谱信息 return { content: [ { type: "text", text: JSON.stringify(foundRecipe, null, 2), }, ], }; } ); } - src/index.ts:60-60 (registration)Invocation of registerGetRecipeByIdTool(server, recipes) within createServerInstance() to register the tool during server setup.
registerGetRecipeByIdTool(server, recipes);