Notion集成膳食规划系统

一个基于Python的Notion集成膳食规划系统,通过多智能体系统帮助用户制定健康的周膳食计划。

  • by garnaud
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 garnaud/meals-mcp

使用说明

MCP膳食

这个项目是一个基于Python的MCP(任务控制平面),用于与Notion交互。

设置

  1. 安装紫外线:

    pip install uv
    
  2. 创建虚拟环境:

    uv venv
    
  3. 激活虚拟环境:

    source .venv/bin/activate
    
  4. 安装依赖项:

    uv pip install -e .
    
  5. 设置您的Notion API密钥:

    创建一个 .env 文件,并添加您的Notion API密钥:

    NOTION_TOKEN="your_notion_api_key"
    

用法

要运行主应用程序(CLI示例):

meals-mcp

要运行MCP服务器,请执行以下操作:

meals-mcp-server

膳食计划代理系统

该项目包括一个先进的多智能体系统,可以根据您的Notion历史和特定的家庭限制来计划您的每周用餐。

运作原理

该系统使用三个专业代理:

  • 计划员: 从Notion检索过去3个月的膳食,并创建一个遵守约束的计划草案(周一/周二的简单膳食、周六中午的清淡膳食等)。
  • 饮食教练: 确保计划是平衡和健康的,如果需要迭代,向计划员提供反馈。
  • 炊具: 一旦计划获得批准,这位法国厨师角色就会为每顿饭提供简洁的食谱卡、提示和估计持续时间。

用法

  1. 设置您的Google API密钥: 特工需要进入双子座。导出API密钥:

    export GOOGLE_API_KEY="your_google_api_key"
    
  2. 运行交互式脚本:

    uv run python scripts/plan_week.py
    
  3. 按照提示操作:

    • 输入一周的日期范围。
    • 审查拟议的计划。
    • 提供反馈(例如,“将周三午餐改为不含鸡肉的午餐”)或确认计划。
    • 收到您的最终购物清单(5人)和厨师食谱卡!

在Gemini中本地使用MCP

要在本地将此MCP服务器与Gemini桌面应用程序一起使用,您需要将其添加到Gemini配置文件中。

  1. 找到Gemini配置文件:

    • macOS: ~/Library/Application Support/Google/Gemini/gemini_config.json (或类似路径,具体取决于确切版本)
    • 或者,检查Gemini应用程序的“管理MCP服务器”设置。
  2. 添加服务器配置:

    将以下条目添加到 mcpServers 配置文件中的对象。确保更换 /path/to/your/meals-mcp 带有此项目目录的实际绝对路径。

    {
      "mcpServers": {
        "meals-mcp": {
          "command": "uv",
          "args": [
            "run",
            "meals-mcp-server"
          ],
          "cwd": "/path/to/your/meals-mcp",
          "env": {
            "NOTION_TOKEN": "your_notion_api_key"
          }
        }
      }
    }
    

    注意:您可以硬编码 NOTION_TOKEN 在 env 部分(如上所示)或确保 .env 文件已由环境正确加载。

  3. 重新启动Gemini: 重新启动Gemini应用程序以使更改生效。

  4. 验证: 让双子座“列出我最近吃的饭”来验证这种联系。

测试

要运行测试,请执行以下操作:

uv run pytest