Food Data Central MCP Server
Servidor MCP de Food Data Central
Este es un servidor de Protocolo de Contexto de Modelo (MCP) para exponer el acceso de API a la API FoodData Central del USDA .
Características
Busque alimentos en la base de datos FoodData Central del USDA
Acceda a la información nutricional de los alimentos
Resultados paginados
Compatibilidad con múltiples tipos de datos (Foundation, SR Legacy, Survey, Branded)
Related MCP server: nutrition-mcp-server
Configuración
Clonar el repositorio
Instalar dependencias:
npm installConstruir el proyecto:
npm run build
Ejecución del servidor
El servidor utiliza el transporte stdio, lo que significa que está diseñado para ser ejecutado como subproceso por un cliente MCP. Para ejecutarlo directamente:
# Set the USDA API key as an environment variable
export USDA_API_KEY=your-api-key-here
npm startPara desarrollo con recarga en caliente:
# Set the USDA API key as an environment variable
export USDA_API_KEY=your-api-key-here
npm run devUso con Claude Desktop
Para utilizar este servidor MCP con Claude Desktop:
Abra la configuración de Claude Desktop:
En macOS: haga clic en el menú Claude y seleccione "Configuración..."
En Windows: haga clic en el menú Claude y seleccione "Configuración..."
En el panel de Configuración, haga clic en "Desarrollador" en la barra de la izquierda y luego haga clic en "Editar configuración".
Esto creará o abrirá un archivo de configuración en:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonVentanas:
%APPDATA%\Claude\claude_desktop_config.json
Agregue el servidor MCP de Food Data Central al archivo de configuración:
{ "mcpServers": { "food-data-central": { "command": "npx", "args": ["tsx", "/path/to/food-data-central-mcp-server/src/index.ts"], "env": { "PATH": "/opt/homebrew/bin", "USDA_API_KEY": "<INSERT KEY HERE>" } } } }Reemplace
/path/to/food-data-central-mcp-servercon la ruta absoluta a este repositorio y<INSERT KEY HERE>con su clave API del USDA real.Nota: Si está en Windows, es posible que deba ajustar el valor de PATH para incluir su directorio de instalación global de npm.
Guarde el archivo de configuración y reinicie Claude Desktop
Tras reiniciar, deberías ver el icono de un martillo en la esquina inferior derecha del cuadro de entrada. Haz clic en él para ver las herramientas disponibles.
Ahora Claude podrá acceder a la API de Food Data Central a través de este servidor MCP. Puedes pedirle que busque alimentos, obtenga información nutricional o recupere datos detallados sobre alimentos.
Recursos y herramientas de MCP
Recursos
food://details- Obtenga información detallada sobre un alimento específico por IDParámetros de consulta:
fdcId: ID de Food Data Central (obligatorio)format: Opcional. 'abreviado' para un conjunto abreviado de elementos, 'completo' para todos los elementos (predeterminado)nutrients: Opcional. Lista de hasta 25 números de nutrientes (separados por comas).
food://foods- Obtenga detalles de varios alimentos utilizando los identificadores FDC de entradaParámetros de consulta:
fdcIds: Lista de múltiples ID de FDC (obligatorio, separados por comas)format: Opcional. 'abreviado' para un conjunto abreviado de elementos, 'completo' para todos los elementos (predeterminado)nutrients: Opcional. Lista de hasta 25 números de nutrientes (separados por comas).
food://list- Obtener una lista paginada de alimentosParámetros de consulta:
dataType: Opcional. Filtrar por un tipo de dato específico (lista separada por comas).pageSize: Opcional. Número máximo de resultados a devolver (predeterminado: 50)pageNumber: Opcional. Número de página a recuperar (predeterminado: 1)sortBy: Opcional. Campo por el que ordenar.sortOrder: Opcional. Orden de clasificación, "asc" o "desc".
Herramientas
search-foods- Busca alimentos usando palabras claveParámetros:
query: Términos de búsqueda para encontrar alimentos (obligatorio)dataType: Opcional. Filtra por un tipo de dato específico (matriz de cadenas).pageSize: Opcional. Número máximo de resultados a devolver (predeterminado: 50)pageNumber: Opcional. Número de página a recuperar (predeterminado: 1)sortBy: Opcional. Campo por el que ordenar.sortOrder: Opcional. Orden de clasificación, "asc" o "desc".brandOwner: Opcional. Filtra los resultados según la marca del alimento (solo para alimentos de marca).tradeChannel: Opcional. Filtra alimentos que contengan cualquiera de los canales comerciales especificados.startDate: Opcional. Filtrar alimentos publicados a partir de esta fecha (formato: AAAA-MM-DD)endDate: Opcional. Filtrar alimentos publicados en esta fecha o antes (formato: AAAA-MM-DD)
Ejemplo de uso
Obtenga detalles de los alimentos utilizando el recurso MCP:
food://details?fdcId=2345678&format=fullObtenga múltiples alimentos utilizando el recurso MCP:
food://foods?fdcIds=534358,373052,616350Obtenga una lista de alimentos utilizando el recurso MCP:
food://list?dataType=Foundation,SR Legacy&pageSize=10&pageNumber=1Búsqueda de alimentos utilizando la herramienta MCP:
{
"name": "search-foods",
"arguments": {
"query": "apple",
"dataType": ["Foundation", "SR Legacy"],
"pageSize": 10,
"pageNumber": 1
}
}Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Search foods, compare nutrients, and look up the full USDA FoodData Central database.
USDA FoodData Central nutrition data: search foods, compare macros, and analyze meals.
Food nutrition lookup via natural language, barcode, and image. Database of 1,000,000+ foods.
21Nutrition data for AI agents and LLMs, powered by Edamam’s database of 1,000,000 foods, including 680,000+ with UPC codes. Lookup via natural language and barcode at low cost and low latency. Highly accurate, deterministic data covering macro and micronutrients, allergens, and lifestyle diet tags.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides intelligent access to the USDA nutrition database through AI assistants, enabling users to search foods, compare nutritional content, find foods high in specific nutrients, and query authoritative nutrition data across 7,146+ food items through natural language.1-
- AlicenseAqualityDmaintenanceEnables natural language access to USDA's FoodData Central database with 1M+ foods, supporting search, nutrition facts, food comparison, and daily value calculations.8MIT
- AlicenseNot gradedqualityDmaintenanceProvides access to USDA FoodData Central database, enabling food search, nutrition details, and comparison for dietary analysis via MCP.5MIT
- AlicenseAqualityDmaintenanceAn MCP server that provides a USDA-accurate food database with deterministic macro math, enabling tools like list_foods, get_food, calculate_macros, filter_by_diet, build_meal, and list_available_tags. It allows Claude to look up nutrition facts and solve for exact macro targets offline, without AI or network.6MIT