佛罗伦萨MCP服务器
全面的MCP服务器集合 用于构建个人副厨师环境剂。这种可扩展的架构目前实现 配方搜索和管理 作为基础服务器，计划为膳食计划、食品储藏室库存、杂货配送和餐厅订购提供额外的专用服务器。
🏗️ 架构概述
佛罗伦萨被设计成 多服务器MCP生态系统 其中每个服务器处理食物/烹饪功能的特定领域。服务器通过共享数据模型协同工作，可以独立部署或作为一个完整的套件部署。
🚀 Docker快速入门
- 克隆和设置:
git clone https://github.com/craine-io/florence-mcp-servers.git
cd florence-mcp-servers
make setup- 添加API密钥:
# Edit .env file with your Spoonacular API key
nano .env- 启动服务:
make dev- 测试它是否有效:
make test📦 当前实施情况
- 配方API服务器：通过Spoonaccular API搜索和管理食谱✅
- PostgreSQL数据库：准备用餐计划和库存数据
- Redis缓存：已准备好进行性能优化
- 开发工具：pgAdmin，Redis命令器（可选）
🗺️ 路线图：计划中的MCP服务器
第一阶段(✅ 当前）
- 配方API服务器：配方搜索、详细信息和营养分析
第二阶段(🚧 计划中）
- 膳食计划服务器：根据饮食偏好制定每周/每月膳食计划
- 食品库库存服务器：跟踪成分、保质期和购物需求
- 餐厅送餐服务器：Uber Eats，DoorDash集成订购
第三阶段(📋 计划中）
- 杂货配送服务器：Instacart、亚马逊Fresh集成
- 营养追踪服务器：卡路里追踪、饮食目标监测
- 日历集成服务器：将用餐计划与Google/Outlook日历同步
第四阶段(💡 未来）
- 设备管理服务器：跟踪厨房设备和维护
- 天气集成服务器：根据天气调整用餐建议
- 健康集成服务器：连接健身追踪器和健康应用程序
每台服务器都可以独立工作，也可以作为整个佛罗伦萨生态系统的一部分。
🛠️ 可用命令
make help # Show all available commands
make dev # Start development environment
make prod # Start production environment
make test # Run all tests
make logs # View logs from all services
make clean # Clean up all Docker resources🔧 发展
多服务器架构
该项目的结构便于添加新的MCP服务器：
servers/
├── recipe_api_server/ # ✅ Implemented
├── meal_planning_server/ # 🚧 Planned next
├── pantry_server/ # 📋 Planned
└── [future servers]/ # 💡 Extensible地方发展
# Work on individual servers
cd servers/recipe_api_server
pip install -r requirements.txt
cp .env.example .env
# Edit .env with API keys
python src/main.py
# Work on shared components
cd shared/
# Edit types/, utils/, config/Docker开发
make dev # Start all current services
make shell # Access recipe server container
make logs-recipe # View recipe server logs only
# Future: When more servers are added
make logs-meals # Meal planning server logs
make logs-pantry # Pantry server logs