使用说明
MCP膳食
这个项目是一个基于Python的MCP(任务控制平面),用于与Notion交互。
设置
-
安装紫外线:
pip install uv -
创建虚拟环境:
uv venv -
激活虚拟环境:
source .venv/bin/activate -
安装依赖项:
uv pip install -e . -
设置您的Notion API密钥:
创建一个
.env文件,并添加您的Notion API密钥:NOTION_TOKEN="your_notion_api_key"
用法
要运行主应用程序(CLI示例):
meals-mcp
要运行MCP服务器,请执行以下操作:
meals-mcp-server
膳食计划代理系统
该项目包括一个先进的多智能体系统,可以根据您的Notion历史和特定的家庭限制来计划您的每周用餐。
运作原理
该系统使用三个专业代理:
- 计划员: 从Notion检索过去3个月的膳食,并创建一个遵守约束的计划草案(周一/周二的简单膳食、周六中午的清淡膳食等)。
- 饮食教练: 确保计划是平衡和健康的,如果需要迭代,向计划员提供反馈。
- 炊具: 一旦计划获得批准,这位法国厨师角色就会为每顿饭提供简洁的食谱卡、提示和估计持续时间。
用法
-
设置您的Google API密钥: 特工需要进入双子座。导出API密钥:
export GOOGLE_API_KEY="your_google_api_key" -
运行交互式脚本:
uv run python scripts/plan_week.py -
按照提示操作:
- 输入一周的日期范围。
- 审查拟议的计划。
- 提供反馈(例如,“将周三午餐改为不含鸡肉的午餐”)或确认计划。
- 收到您的最终购物清单(5人)和厨师食谱卡!
在Gemini中本地使用MCP
要在本地将此MCP服务器与Gemini桌面应用程序一起使用,您需要将其添加到Gemini配置文件中。
-
找到Gemini配置文件:
- macOS:
~/Library/Application Support/Google/Gemini/gemini_config.json(或类似路径,具体取决于确切版本) - 或者,检查Gemini应用程序的“管理MCP服务器”设置。
- macOS:
-
添加服务器配置:
将以下条目添加到
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文件已由环境正确加载。 -
重新启动Gemini: 重新启动Gemini应用程序以使更改生效。
-
验证: 让双子座“列出我最近吃的饭”来验证这种联系。
测试
要运行测试,请执行以下操作:
uv run pytest