AI导哈

食谱管理服务器

一个为Mealie（自托管食谱管理和膳食计划应用）提供的MCP服务器，使LLMs能够通过Mealie实例管理食谱、膳食计划、购物清单等。

  • by GraysonCAdams
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 GraysonCAdams/mealie-mcp

使用说明

Mealie MCP服务器

一 MCP（模型上下文协议） 服务器 米莉 --自助式食谱经理和膳食计划员。为LLM提供完全访问权限，通过您的Mealie实例管理食谱、膳食计划、购物清单等。

工具

食谱

工具 说明
get_recipes 通过按类别、标签、工具和高级查询过滤器过滤来搜索和列出食谱
get_recipe_detailed 获取完整的食谱详细信息，包括配料、说明和元数据
get_recipe_concise 获取食谱摘要（名称、份数、时间、成分、评分）
create_recipe 创建一个包含名称、配料和说明的新食谱
update_recipe 替换现有配方的成分和说明
patch_recipe 部分更新配方元数据（名称、描述、时间、份量、评级等）
duplicate_recipe 复制现有配方
delete_recipe 永久删除配方
mark_recipe_last_made 将食谱标记为今天做的
get_recipe_suggestions 根据手头可用的食物和工具获取食谱建议
create_recipe_from_url 通过从URL抓取来导入食谱
create_recipes_from_url_bulk 一次从URL导入多个食谱
test_scrape_url 预览从URL抓取的配方数据而不保存
set_recipe_image_from_url 通过从URL抓取配方图像来设置配方图像
upload_recipe_image_file 上传配方的本地图像文件
upload_recipe_asset_file 上传配方的文档/资产文件

膳食计划

工具 说明
get_all_mealplans 通过可选的日期范围过滤获取用餐计划
get_todays_mealplan 获取今天的膳食计划条目
get_mealplan 通过ID获取特定的膳食计划条目
create_mealplan 创建膳食计划条目（早餐、午餐、晚餐、配菜、小吃、饮料、甜点）
create_mealplan_bulk 一次创建多个膳食计划条目
create_random_mealplan 使用随机选择的食谱创建膳食计划条目
update_mealplan 更新膳食计划条目
delete_mealplan 删除膳食计划条目

购物单

工具 说明
get_shopping_lists 获取所有购物清单
get_shopping_list 获取包含所有商品的特定购物清单
create_shopping_list 创建新的购物清单
delete_shopping_list 删除购物清单
add_recipe_to_shopping_list 将食谱的配料添加到购物清单中
remove_recipe_from_shopping_list 从购物清单中删除食谱的成分

购物清单项目

工具 说明
get_shopping_list_items 通过搜索和分页获取所有购物清单项目
get_shopping_list_item 获取特定的购物清单项目
create_shopping_list_item 在购物清单中创建新项目
create_shopping_list_items_bulk 一次创建多个购物清单项目
update_shopping_list_item 更新购物清单项目（选中/取消选中、修改、分配标签）
update_shopping_list_items_bulk 一次更新多个购物清单项目
delete_shopping_list_item 删除购物清单项目
delete_shopping_list_items_bulk 一次删除多个购物清单项目

分类

工具 说明
get_categories 获取所有食谱类别
get_category 按ID获取类别
get_category_by_slug 按slug获取类别
get_empty_categories 获取没有食谱的类别
create_category 创建新类别
update_category 更新类别
delete_category 删除类别

标签

工具 说明
get_tags 获取所有食谱标签
get_tag 按ID获取标签
get_tag_by_slug 通过slug获取标签
get_empty_tags 获取没有食谱的标签
create_tag 创建新标签
update_tag 更新标签
delete_tag 删除标签

食物

工具 说明
get_foods 获取所有食物（数据库中的成分）
get_food 通过ID获取特定食物
create_food 创造新食物
update_food 更新食物的详细信息
delete_food 删除食物
merge_foods 将一种食物合并到另一种食物中（更新所有参考文献）

单位

工具 说明
get_units 获取所有测量单位
get_unit 按ID获取特定单位
create_unit 创建新单位
update_unit 更新单位的详细信息
delete_unit 删除单位
merge_units 将一个单元合并到另一个单元中（更新所有引用）

工具（厨房设备）

工具 说明
get_tools 获取所有厨房工具/设备
get_tool 按ID获取工具
get_tool_by_slug 用slug得到一个工具
create_tool 创建新工具
update_tool 更新工具
delete_tool 删除工具

标签

工具 说明
get_labels 获取所有多用途标签（用于购物清单项目分类）
get_label 按ID获取标签
create_label 创建新标签
update_label 更新标签的名称或颜色
delete_label 删除标签

烹饪书籍

工具 说明
get_cookbooks 获取所有食谱（精选食谱集）
get_cookbook 按ID获取烹饪书
create_cookbook 使用可选的查询过滤器创建新的烹饪书
update_cookbook 更新食谱
delete_cookbook 删除烹饪书

评论

工具 说明
get_recipe_comments 获取食谱的所有评论
create_comment 为食谱添加评论
update_comment 更新评论
delete_comment 删除评论

成分分析器

工具 说明
parse_ingredient 将单一成分字符串解析为结构化数据（数量、单位、食物）
parse_ingredients 一次解析多个成分字符串

用户和家庭

工具 说明
get_current_user 获取当前用户的个人资料信息
get_user_favorites 获取当前用户最喜欢的食谱
get_user_ratings 获取当前用户的食谱评级
add_favorite 将食谱添加到收藏夹
remove_favorite 从收藏夹中删除食谱
set_recipe_rating 对食谱进行评分（0-5）和/或设置收藏夹状态
get_household_statistics 获取家庭统计数据（总食谱、类别、标签等）

提示

提示 描述
weekly_meal_plan 交互式每周膳食计划工作流程，搜索您的食谱并制定平衡的7天计划

环境变量

变量 必填 描述
MEALIE_BASE_URL 是 您的Mealie实例的基本URL（例如。， https://mealie.example.com)
MEALIE_API_KEY 是 使用Mealie进行身份验证的API密钥（在Mealie中的用户>API令牌下生成）
LOG_LEVEL 否 日志记录级别（默认值： INFO)
MCP_TRANSPORT 否 运输方式： stdio （默认）或 sse

设置

需要Python 3.12+和 紫外线.

# Clone the repo
git clone https://github.com/GraysonCAdams/mealie-mcp.git
cd mealie-mcp

# Install dependencies
uv sync

# Set environment variables
export MEALIE_BASE_URL="https://mealie.example.com"
export MEALIE_API_KEY="your-api-key-here"

或者创建一个 .env 项目根目录中的文件：

MEALIE_BASE_URL=https://mealie.example.com
MEALIE_API_KEY=your-api-key-here

跑步

stdio模式（用于直接MCP客户端连接）

uv run src/server.py

带有mcp代理的HTTP模式

mcp-proxy --port 8004 -- uv run src/server.py

Claude桌面配置

添加到您的Claude桌面配置(claude_desktop_config.json):

{
  "mcpServers": {
    "mealie": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/mealie-mcp", "src/server.py"],
      "env": {
        "MEALIE_BASE_URL": "https://mealie.example.com",
        "MEALIE_API_KEY": "your-api-key-here"
      }
    }
  }
}

许可证

麻省理工学院

相关 MCP