Canada's Food Guide

🍲 Canada's Food Guide - MCP Server

📝 Descrição

O FoodGuide MCP Server reúne três recursos poderosos da Health Canada em um único conjunto de ferramentas para análise nutricional abrangente:

• Receitas Oficiais: Pesquise e extraia dados do banco de receitas do Canada's Food Guide.
• Banco de Dados CNF: Obtenha dados nutricionais exatos de ingredientes pela Canadian Nutrient File API.
• Cálculos de DRI: Use as tabelas de Ingestão Dietética de Referência em cache para calcular metas de macronutrientes específicas por demografia e necessidades energéticas (EER).

Exemplo	Vídeo
Encontre receitas temáticas para uma semana
Sugira receitas a partir de uma imagem de suas compras
Calcule sua ingestão estimada de macros e necessidades energéticas
Calcule macros para uma receita

Dois modos de configuração:

Modo	Ferramentas disponíveis	Banco de dados/armazenamento?	Melhor para
HTTP (remoto/auto-hospedado)	Ferramentas de extração + cálculo (24 ferramentas)	Não	A maioria dos usuários — consultas nutricionais, busca de receitas, cálculos de EER/DRI
stdio (completo)	Todas as ferramentas, incluindo SQLite (46 ferramentas)	Sim	Usuários avançados — análise de macros de receitas, favoritos, perfis de usuário

Consulte IMPLEMENTATIONS.MD se quiser contribuir ou colaborar! Sempre em busca de sugestões!

Você pode usar esta planilha do Google para verificar os cálculos de EER e CNF mostrados nos vídeos de demonstração no repositório atual.

📑 Índice

• 📝 Descrição
• 📥 Instalação
• 🚀 Configuração por Cliente

📥 Instalação

1. Pré-requisitos:

   • Python 3.10 ou superior
   • pip (instalador de pacotes Python)

2. Clone o repositório:

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

3. Instale as dependências:

   pip3 install -r requirements.txt
   

4. Encontre seu caminho do Python (necessário para a configuração do cliente):

   which python3
   

5. Obtenha o caminho absoluto do projeto:

   pwd
   

Modo HTTP — extração + cálculo, sem banco de dados (24 ferramentas)

Inicie o servidor em um terminal e deixe-o em execução:

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

Em seguida, configure seu cliente para conectar a http://localhost:8000/mcp — veja Configuração por Cliente abaixo.

Modo completo — todas as ferramentas, incluindo SQLite (46 ferramentas)

Execute via stdio — nenhum processo de servidor separado é necessário. Configure seu cliente com os trechos stdio em Configuração por Cliente.

---

🚀 Configuração por Cliente

Modo	Ferramentas de banco de dados?	Ferramentas disponíveis
HTTP (inicie o servidor primeiro)	Não	Extração + cálculo (24 ferramentas)
stdio (completo)	Sim	Todas as ferramentas, incluindo SQLite (46 ferramentas)

---

Modo HTTP — extração + cálculo (sem banco de dados)

Antes de configurar seu cliente: inicie o servidor em um terminal separado:

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

Mantenha-o em execução enquanto usa seu cliente.

A maioria dos clientes usa mcp-proxy para fazer a ponte entre stdio e HTTP. O Claude Code conecta de forma nativa.

Claude Desktop

Navegue até: Claude Desktop → Configurações (⌘,) → Desenvolvedor → Editar Configuração

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

Reinicie o Claude Desktop após salvar.

Claude Code

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

Cursor

Em .cursor/mcp.json (projeto) ou ~/.cursor/mcp.json (global):

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

VS Code (GitHub Copilot)

Em .vscode/mcp.json:

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

---

Modo completo — todas as ferramentas, incluindo banco de dados SQLite

Nenhum processo de servidor separado é necessário. O cliente inicia o servidor diretamente via stdio.

Substitua <python-path> e <project-path> pelos seus caminhos reais das etapas de Instalação.

Caminhos comuns do Python por sistema:

• Homebrew (Mac): /opt/homebrew/bin/python3
• Python do sistema (Mac): /usr/bin/python3
• Anaconda: /opt/anaconda3/bin/python3
• Linux: /usr/bin/python3

Claude Desktop

Navegue até: Claude Desktop → Configurações (⌘,) → Desenvolvedor → Editar Configuração

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

Reinicie o Claude Desktop após salvar.

Claude Code

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

Cursor

Em .cursor/mcp.json (projeto) ou ~/.cursor/mcp.json (global):

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

VS Code (GitHub Copilot)

Em .vscode/mcp.json:

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

---

Sinalizadores opcionais

# 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

Solução de problemas

• Se o servidor não aparecer, verifique os logs do Claude Desktop para mensagens de erro
• Verifique se o Python 3.10+ está instalado: python3 --version
• Para o modo HTTP, verifique se o servidor está em execução: curl http://localhost:8000/mcp/

---