USDA api

🍎 Ferramentas de Alimentos do USDA para Claude

Adicione dados poderosos de alimentos e nutrição ao Claude for Desktop usando o banco de dados abrangente de alimentos do USDA.

🚀 Para Usuários - Instalação Rápida

Opção 1: Instalador GUI (Recomendado)

1. Baixe: USDA Food Tools Installer.zip (11KB)
2. Extraia e clique duas vezes no aplicativo
3. Obtenha a Chave da API: Grátis em api.nal.usda.gov
4. Siga o instalador - abre no seu navegador
5. Reinicie o Claude - as ferramentas aparecem automaticamente!

Opção 2: Linha de Comando

curl -sSL https://raw.githubusercontent.com/yourusername/usda-api-mcp/main/install.sh | bash

🔍 O Que Você Obtém

• Pesquisar Alimentos - Encontre qualquer alimento com fatos nutricionais detalhados
• Análise Nutricional - Composição completa de nutrientes
• Informações de Marca - Ingredientes, categorias, fabricantes
• Consultas em Lote - Vários alimentos de uma vez
• Dados de Pesquisa - O banco de dados de alimentos padrão-ouro do USDA

📋 Requisitos

• Claude for Desktop (versão mais recente)
• Chave de API USDA gratuita em api.nal.usda.gov
• macOS 10.15+ (instalador GUI) ou Python 3.11+ (linha de comando)

💬 Exemplo de Uso

Depois de instalado, pergunte ao Claude:

• "Quais são as informações nutricionais do salmão?"
• "Compare a proteína do peito de frango com a do tofu"
• "Encontre alimentos de café da manhã ricos em fibras"
• "Mostre o conteúdo de vitaminas do espinafre"

---

🛠️ Para Desenvolvedores

Configuração de Desenvolvimento

# Clone the repository
git clone https://github.com/yourusername/usda-api-mcp.git
cd usda-api-mcp

# Install dependencies
uv sync

# Set up environment
echo "USDA_API_KEY=your_key_here" > .env

# Run the MCP server
uv run main.py

Estrutura do Projeto

usda-api-mcp/
├── main.py              # MCP server implementation
├── gui_installer.py     # Web-based GUI installer
├── install.sh          # Command-line installer
├── pyproject.toml      # Dependencies
├── create_app.sh       # Build Mac app bundle
└── dist/               # Distribution files

Ferramentas MCP Disponíveis

• search_foods(query, page_size, page_number) - Pesquisar banco de dados de alimentos
• get_food_details(fdc_id, nutrients) - Obter informações detalhadas de alimentos
• get_multiple_foods(fdc_ids, nutrients) - Consulta em lote de alimentos
• list_foods(data_type, page_size, page_number) - Navegar por alimentos
• get_food_nutrients(fdc_ids, nutrients) - Obter nutrientes específicos

Criando Releases

# Build Mac app bundle
./create_app.sh

# Create distribution zip
cd dist && zip -r "USDA-Food-Tools-Installer.zip" "USDA Food Tools Installer.app"

# Test the app
open "USDA Food Tools Installer.app"

Integração com a API

O servidor se integra com a API USDA FoodData Central v2:

• URL Base: https://api.nal.usda.gov/fdc/v2/
• Autenticação: chave de API em parâmetros de consulta
• Limites de Taxa: 3600 solicitações/hora (nível gratuito)
• Tipos de Dados: Foundation, SR Legacy, Survey, alimentos de marca

Contribuindo

1. Faça um fork do repositório
2. Crie um branch de recurso: git checkout -b feature-name
3. Faça suas alterações e teste minuciosamente
4. Envie um pull request

Testes

# Test MCP server directly
uv run main.py

# Test GUI installer
python3 gui_installer.py

# Test command-line installer
./install.sh

Implantação

O projeto usa uma abordagem simples de pacote de aplicativo Mac:

• Sem empacotamento complexo (problemas do py2app resolvidos)
• Inicializador de script shell com Python embutido
• Autocontido com resolução de conflitos de porta
• Limpeza automática de processos existentes