USDA api

Este servidor te permite hacer preguntas con datos nutricionales mucho más precisos.

GitHub
1
Prueba este MCPPatrocinado

Documentación

🍎 Herramientas de Alimentos USDA para Claude

Añade potentes datos de alimentos y nutrición a Claude para Desktop utilizando la completa base de datos de alimentos del USDA.

🚀 Para Usuarios - Instalación Rápida

Opción 1: Instalador GUI (Recomendado)

  1. Descargar: USDA Food Tools Installer.zip (11KB)
  2. Extraer y hacer doble clic en la aplicación
  3. Obtener Clave API: Gratis en api.nal.usda.gov
  4. Seguir el instalador - se abre en tu navegador
  5. Reiniciar Claude - ¡las herramientas aparecen automáticamente!

Opción 2: Línea de Comandos

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

🔍 Lo Que Obtienes

  • Buscar Alimentos - Encuentra cualquier alimento con datos nutricionales detallados
  • Análisis Nutricional - Desgloses completos de nutrientes
  • Información de Marcas - Ingredientes, categorías, fabricantes
  • Consultas Masivas - Múltiples alimentos a la vez
  • Datos de Investigación - La base de datos de alimentos estándar de oro del USDA

📋 Requisitos

  • Claude para Desktop (última versión)
  • Clave API gratuita del USDA desde api.nal.usda.gov
  • macOS 10.15+ (instalador GUI) o Python 3.11+ (línea de comandos)

💬 Ejemplo de Uso

Una vez instalado, pregúntale a Claude:

  • "¿Cuál es la información nutricional del salmón?"
  • "Compara la proteína de pechuga de pollo vs tofu"
  • "Encuentra alimentos para desayuno ricos en fibra"
  • "Muestra el contenido de vitaminas de las espinacas"

🛠️ Para Desarrolladores

Configuración de Desarrollo

# 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

Estructura del Proyecto

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

Herramientas MCP Disponibles

  • search_foods(query, page_size, page_number) - Buscar en la base de datos de alimentos
  • get_food_details(fdc_id, nutrients) - Obtener información detallada de alimentos
  • get_multiple_foods(fdc_ids, nutrients) - Consulta masiva de alimentos
  • list_foods(data_type, page_size, page_number) - Explorar alimentos
  • get_food_nutrients(fdc_ids, nutrients) - Obtener nutrientes específicos

Creación de Versiones

# 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"

Integración de API

El servidor se integra con la API v2 de USDA FoodData Central:

  • URL Base: https://api.nal.usda.gov/fdc/v2/
  • Autenticación: Clave API en parámetros de consulta
  • Límites de Velocidad: 3600 solicitudes/hora (nivel gratuito)
  • Tipos de Datos: Foundation, SR Legacy, Survey, alimentos de marca

Contribuciones

  1. Haz un fork del repositorio
  2. Crea una rama de características: git checkout -b feature-name
  3. Realiza tus cambios y prueba a fondo
  4. Envía una solicitud de pull

Pruebas

# Test MCP server directly
uv run main.py

# Test GUI installer
python3 gui_installer.py

# Test command-line installer
./install.sh

Despliegue

El proyecto utiliza un enfoque simple de paquete de aplicación Mac:

  • Sin empaquetado complejo (problemas de py2app resueltos)
  • Lanzador de script shell con Python integrado
  • Autocontenido con resolución de conflictos de puertos
  • Limpieza automática de procesos existentes