🍲

🍲 加拿大膳食指南 - MCP 服务

📝 描述

FoodGuide MCP 服务 将加拿大卫生部的三项强大资源整合为一套工具，可进行全面的营养分析：

• 官方食谱： 搜索并抓取加拿大膳食指南食谱数据库。
• CNF 数据库： 从加拿大营养成分文件 API获取食材的精确营养素数据。
• DRI 计算： 使用缓存的膳食参考摄入量表格，计算特定人口群体的宏量营养素目标和能量需求（EER）。

示例	视频
查找一周的主题食谱
根据杂货图片推荐食谱
计算预估的宏量营养素摄入量和能量需求
计算食谱的宏量营养素

两种设置模式：

模式	可用工具	数据库/存储？	适用于
HTTP（远程/可自托管）	抓取 + 计算工具（24 个工具）	否	大多数用户——营养查询、食谱搜索、EER/DRI 计算
stdio（完整）	所有工具，包括 SQLite（46 个工具）	是	高级用户——食谱宏量营养素分析、收藏夹、用户资料

如果你想贡献或协作，请查看 IMPLEMENTATIONS.MD！我们一直欢迎建议！

你可以使用此Google 表格，验证当前仓库预告视频中展示的 EER 和 CNF 计算结果。

📑 目录

• 📝 描述
• 📥 安装
• 🚀 按客户端设置

📥 安装

1. 前置条件：

   • Python 3.10 或更高版本
   • pip（Python 包安装程序）

2. 克隆仓库：

   git clone https://github.com/Aryan-Jhaveri/mcp-foodguidecanada
   cd mcp-foodguidecanada
   

3. 安装依赖：

   pip3 install -r requirements.txt
   

4. 查找 Python 路径（客户端配置时需要）：

   which python3
   

5. 获取项目的绝对路径：

   pwd
   

HTTP 模式——抓取 + 计算，无数据库（24 个工具）

在终端中启动服务并保持运行：

python3 src/server.py --transport http --port 8000
# Server running at http://0.0.0.0:8000/mcp

然后将客户端配置为连接到 http://localhost:8000/mcp——参见下方的按客户端设置。

完整模式——所有工具，包含 SQLite（46 个工具）

通过 stdio 运行——无需单独启动服务进程。使用按客户端配置中的 stdio 配置片段配置客户端。

---

🚀 按客户端配置

模式	数据库工具？	可用工具
HTTP（先启动服务）	否	抓取 + 计算（24 个工具）
stdio（完整）	是	所有工具，包含 SQLite（46 个工具）

---

HTTP 模式——抓取 + 计算（无数据库）

**配置客户端之前：**在单独的终端中启动服务：

python3 src/server.py --transport http --port 8000

使用客户端期间，请保持服务运行。

大多数客户端会使用 mcp-proxy 将 stdio 桥接到 HTTP。Claude Code 可原生连接。

Claude Desktop

前往：Claude Desktop → Settings（⌘,）→ Developer → Edit Config

{
  "mcpServers": {
    "FoodGuideSousChef": {
      "command": "uvx",
      "args": ["mcp-proxy", "--transport", "streamablehttp", "http://localhost:8000/mcp"]
    }
  }
}

保存后重启 Claude Desktop。

Claude Code

claude mcp add FoodGuideSousChef --transport http http://localhost:8000/mcp

Cursor

在 .cursor/mcp.json（项目级）或 ~/.cursor/mcp.json（全局）中：

{
  "mcpServers": {
    "FoodGuideSousChef": {
      "command": "uvx",
      "args": ["mcp-proxy", "--transport", "streamablehttp", "http://localhost:8000/mcp"]
    }
  }
}

VS Code（GitHub Copilot）

在 .vscode/mcp.json 中：

{
  "servers": {
    "FoodGuideSousChef": {
      "type": "stdio",
      "command": "uvx",
      "args": ["mcp-proxy", "--transport", "streamablehttp", "http://localhost:8000/mcp"]
    }
  }
}

---

完整模式——所有工具，包含 SQLite 数据库

无需单独启动服务进程。客户端通过 stdio 直接启动服务。

将 <python-path> 和 <project-path> 替换为安装步骤中使用的实际路径。

各系统常见的 Python 路径：

• Homebrew（Mac）：/opt/homebrew/bin/python3
• 系统 Python（Mac）：/usr/bin/python3
• Anaconda：/opt/anaconda3/bin/python3
• Linux：/usr/bin/python3

Claude Desktop

前往：Claude Desktop → Settings（⌘,）→ Developer → Edit Config

{
  "mcpServers": {
    "FoodGuideSousChef": {
      "command": "<python-path>",
      "args": ["<project-path>/src/server.py"],
      "cwd": "<project-path>"
    }
  }
}

保存后重启 Claude Desktop。

Claude Code

claude mcp add FoodGuideSousChef -- <python-path> <project-path>/src/server.py

Cursor

在 .cursor/mcp.json（项目级）或 ~/.cursor/mcp.json（全局）中：

{
  "mcpServers": {
    "FoodGuideSousChef": {
      "command": "<python-path>",
      "args": ["<project-path>/src/server.py"],
      "cwd": "<project-path>"
    }
  }
}

VS Code（GitHub Copilot）

在 .vscode/mcp.json 中：

{
  "servers": {
    "FoodGuideSousChef": {
      "type": "stdio",
      "command": "<python-path>",
      "args": ["<project-path>/src/server.py"],
      "cwd": "<project-path>"
    }
  }
}

---

可选标志

# HTTP mode with custom port
python3 src/server.py --transport http --port 9000 --host 0.0.0.0

# Environment variable alternative (for deployment)
MCP_TRANSPORT=http PORT=8000 python3 src/server.py

故障排除

• 如果未显示服务，请检查 Claude Desktop 日志中的错误消息
• 确认已安装 Python 3.10+：python3 --version
• 对于 HTTP 模式，确认服务正在运行：curl http://localhost:8000/mcp/

---