关键词

AI助手食谱管理餐食计划Mealie智能厨房

项目简介

这个项目是一个基于Model Context Protocol (MCP) 实现的服务器，旨在让AI助手（如Claude Desktop）能够连接并操作您的Mealie食谱管理系统。它通过提供标准化的工具和提示模板，使得AI能够查询食谱、创建餐食计划，并进行食谱的增删改查。

主要功能点

  • 食谱管理: AI可以搜索、获取详细或简洁的食谱信息，甚至创建和更新食谱的配料和步骤。例如，您可以让AI查询含有特定食材的食谱，或者更新现有食谱的制作方法。
  • 餐食计划: AI能够查看现有餐食计划、获取今日餐食计划，并支持批量创建新的餐食计划条目，帮助用户高效规划一周膳食。AI可以根据您的偏好，生成并保存个性化的餐食方案。
  • 智能交互: 通过预定义的提示模板，AI可以更好地理解用户意图，例如生成个性化的每周餐食计划，并提供详细的食材、烹饪步骤以及营养建议。

安装步骤

  1. 前置条件:
    • 您的系统已安装 Python 3.12+。
    • 一个正在运行的 Mealie 实例，并且您拥有其API密钥。
    • 建议安装包管理器 'uv' (可以通过 'pip install uv' 安装，或参考 uv官方安装指南)。
  2. 克隆仓库: 打开终端或命令行工具，执行以下命令克隆项目仓库： 
    git clone https://github.com/rldiao/mealie-mcp-server.git
cd mealie-mcp-server
  3. 安装依赖: 在项目根目录下，使用 'uv' 安装所有必要的Python依赖： 
    uv sync
  4. 配置环境: 复制项目根目录下的 '.env.template' 文件为 '.env'： 
    cp .env.template .env
    然后编辑新创建的 '.env' 文件，填入您的Mealie实例的URL和API密钥： 
    MEALIE_BASE_URL=https://your-mealie-instance.com  # 替换为您的Mealie实例URL
MEALIE_API_KEY=your-mealie-api-key              # 替换为您的Mealie API密钥

服务器配置 (MCP客户端专用)

要将此Mealie MCP服务器连接到您的MCP客户端（例如Claude Desktop），您需要在客户端的配置文件中添加以下JSON条目。请将 '/path/to/repo/src' 替换为 'mealie-mcp-server' 仓库中 'src' 目录的实际路径。

  • 'mcpServers': 这是一个JSON对象，用于定义所有MCP服务器。
  • 'mealie-mcp-server': 这是您为此服务器定义的名称，可以自定义。
  • 'command': 启动服务器的命令，这里推荐使用 'uv'。
  • 'args': 传递给 'uv' 命令的参数列表。
    • '--directory /path/to/repo/src': 指定 'src' 目录为工作目录。
    • 'run server.py': 执行 'src' 目录下的 'server.py' 脚本以启动MCP服务器。
  • 'env': 服务器运行所需的环境变量。
    • 'MEALIE_BASE_URL': 您的Mealie实例的URL。
    • 'MEALIE_API_KEY': 访问Mealie API的密钥。

以下是示例配置（请注意，JSON格式本身不支持注释，以下注释仅为说明）：

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

基本使用方法

配置完成后，您的MCP客户端（如Claude Desktop）将能够发现并连接到此服务器。通过AI助手的聊天界面，您可以：

  • 查询食谱: 询问“帮我搜索包含鸡肉的食谱。”
  • 获取食谱详情: 请求“获取食谱‘经典番茄意面’的详细信息。”
  • 创建餐食计划: 让AI“为我生成一份下周的餐食计划，我喜欢素食。” AI会利用Mealie数据库中的食谱为您安排。
  • 修改餐食计划: 指示AI“在周二的午餐添加食谱‘快速鸡肉沙拉’。”

信息

分类

AI与计算

访问项目