Edamam Remote Food MCP
El MCP remoto de Edamam le brinda a una IA la capacidad de "entender" los alimentos de la misma manera que lo haría un nutricionista, traduciendo descripciones en lenguaje natural, imágenes o códigos de barras en información nutricional y alimentaria estructurada.
Documentación
Las APIs de alimentos están hechas para aplicaciones. MCP las hace útiles en flujos de trabajo de agentes.
Edamam Food MCP convierte la Food Database API en un pequeño conjunto de herramientas amigables para LLMs. El agente mantiene la conversación natural, mientras que el servidor maneja el análisis de alimentos, la resolución de cantidades, la búsqueda por código UPC, el cálculo nutricional y el análisis de platos basado en imágenes.
01
Un solo endpoint para agentes
Usa un único endpoint MCP para initialize, tools/list y tools/call. Sin capa de adaptadores personalizados para cada asistente o herramienta de automatización.
02
Nutrición desde lenguaje natural
Envía frases como "cheddar cheese", "1 cup cooked rice", "200g chicken breast" o un código de barras UPC/EAN.
03
Análisis de imágenes de alimentos
Proporciona una URL pública de imagen o un data URI en base64 y devuelve los alimentos detectados junto con estimaciones nutricionales de la API Vision de Edamam.
El agente pregunta de forma natural. El servidor MCP devuelve nutrición estructurada.
Usuario
Almorcé un chicken enchilada y una French onion soup con una rebanada de pan. ¿Cuántas calorías tiene esto?
Agente
Según los datos nutricionales proporcionados (1 porción completa de cada uno):
Calorías (total del almuerzo)
- Chicken enchilada (1 pieza): 503.7 kcal
- French onion soup (1 pieza): 395.6 kcal
- Pan (1 rebanada): 79.5 kcal
Calorías totales: 978.7 kcal (aprox. 979 kcal)
get_food_nutrition({
"queries": ["1 chicken enchilada", "1 French onion soup", "1 slice of bread"]
})
Usuario
Dame el desglose de macronutrientes y ¿para qué dietas es adecuado?
Agente
Desglose de macronutrientes (almuerzo completo)
- Proteínas: 53.0 g
- Carbohidratos: 81.8 g
- Grasas: 47.8 g
Adecuación dietética: Mejor para una dieta general omnívora/equilibrada. Esta comida no es una buena opción para dietas keto/bajas en carbohidratos, bajas en grasas, bajas en sodio, veganas, vegetarianas, sin gluten o sin lácteos (incluye trigo/gluten y advertencias de leche en los elementos devueltos).
Demo del asistente nutricional con agente MCP
Consulta los datos nutricionales de uno o más alimentos descritos en texto plano. Identifica alimentos en una imagen y devuelve un desglose nutricional completo.
Conecta tu cliente MCP en minutos.
Añade la URL del servidor a tu cliente y pasa las credenciales de Edamam como bearer token. El descubrimiento puede conectarse primero; las llamadas reales a herramientas requieren un app_id y app_key de la Edamam Food Database API.
{
"mcpServers": {
"edamam-food": {
"url": "https://mcp.edamam.com/mcp/food",
"headers": {
"Authorization": "Bearer <app_id>:<app_key>"
}
}
}
}
{
"servers": {
"edamam-food": {
"type": "http",
"url": "https://mcp.edamam.com/mcp/food",
"headers": {
"Authorization": "Bearer <app_id>:<app_key>"
}
}
}
}
claude mcp add --transport http edamam-food \
https://mcp.edamam.com/mcp/food \
--header "Authorization: Bearer <app_id>:<app_key>"
{
"mcpServers": {
"edamam-food": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.edamam.com/mcp/food",
"--header",
"Authorization: Bearer <app_id>:<app_key>"
]
}
}
}
Dos herramientas de producción, ajustadas para preguntas sobre alimentos.
El servidor FastMCP mantiene la superficie del agente intencionalmente compacta. La búsqueda, el análisis, el reconocimiento de UPC y el cálculo de nutrientes se manejan dentro de la herramienta de nutrición; las fotos usan una herramienta Vision dedicada.
tool
get_food_nutrition
Consulta calorías, macronutrientes, etiquetas dietéticas, etiquetas de salud, advertencias, nutrientes totales, valores diarios y datos de ingredientes resueltos para uno o más alimentos.
| Argumento | Tipo | Obligatorio | Descripción |
|---|---|---|---|
queries | list[string] | Sí | Una frase por alimento, como "1 cup rice", "200g chicken breast" o "049000042566". |
Ejemplo de llamada JSON-RPC
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "get_food_nutrition",
"arguments": {
"queries": ["1 croissant", "1 egg"]
}
},
"id": 3
}
tool
analyze_food_image
Identifica alimentos en una fotografía y devuelve el elemento detectado, la cantidad, la medida, las líneas de ingredientes, las calorías, las etiquetas, las advertencias y el desglose completo de nutrientes.
| Argumento | Tipo | Obligatorio | Descripción |
|---|---|---|---|
image | string | Sí | Una URL pública http / https o un URI base64 data:image/.... |
Ejemplo de llamada JSON-RPC
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "analyze_food_image",
"arguments": {
"image": "https://example.com/plate.jpg"
}
},
"id": 4
}
Usa tus credenciales de Edamam sin almacenarlas en el servidor MCP.
Las llamadas a herramientas usan las credenciales de la Food Database API proporcionadas por quien llama. Envía un bearer token con el app_id y app_key unidos por dos puntos.
Authorization: Bearer <app_id>:<app_key>
Para autoalojamiento: establece EDAMAM_APP_ID y EDAMAM_APP_KEY como credenciales de respaldo, o exige que cada llamada pase el encabezado Authorization.
Todo lo necesario para probar, autoalojar e integrar.
El endpoint público es para clientes MCP inmediatos. El repositorio de GitHub contiene el servidor FastMCP, código compartido de autenticación y registro, cobertura de pytest, notas de implementación y ejemplos para llamadas JSON-RPC directas.
Obtener claves de API Documentación de la Food Database API Especificación MCP Streamable HTTP
1
Inicializar
El cliente envía initialize para negociar capacidades y recibe un MCP-Session-Id.
2
Descubrir herramientas
El cliente llama a tools/list y recibe esquemas para get_food_nutrition y analyze_food_image.
3
Llamar herramientas
El cliente envía tools/call con el id de sesión y las credenciales bearer de Edamam.
Mapeado a las rutas de la Food Database API que los agentes más necesitan.
| Capacidad de la Food Database | Mapeo MCP | Estado |
|---|---|---|
| Búsqueda por parser por nombre de alimento o UPC | Paso interno en get_food_nutrition | Disponible |
| Endpoint de nutrientes | get_food_nutrition | Disponible |
| Nutrientes desde imagen | analyze_food_image | Disponible |
| Autocompletado y filtros de navegación | No expuestos como herramientas MCP | Fuera de alcance |
Incluido con los planes de la Edamam Food Database API.
Edamam lista Food MCP como incluido con los planes de la Food Database API. Elige el plan según el volumen de API, el uso de Vision, la limitación de velocidad, los derechos de caché y las necesidades de soporte.
EnterpriseBasic Vision
$14 / mes
- 100,000 llamadas/mes
- 50 llamadas de alimentos y nutrición/min
- 500 solicitudes de Vision/mes
- Período de prueba de 30 días
EnterpriseCore
$69 / mes
- 750,000 llamadas/mes
- 100 llamadas de alimentos y nutrición/min
- Vision de pago por uso
- Soporte por correo electrónico y teléfono
EnterprisePlus
$299 / mes
- 5,000,000 llamadas/mes
- 300 llamadas de alimentos y nutrición/min
- 10,000 solicitudes de Vision/mes
- Soporte por correo electrónico y teléfono
Los detalles de los planes cambian con el tiempo. Confirma los precios, cuotas, derechos de caché y términos actuales en la página de la Edamam Food Database API antes del lanzamiento.
Datos de alimentos de solo lectura, con la responsabilidad de las claves de API en el borde del cliente.
Mantén privadas las claves de la aplicación
Nunca confirmes valores de app_key en el control de versiones ni los pegues en prompts compartidos. Trátalos como contraseñas.
Uso iniciado por humanos
Los términos de la API de Edamam restringen la recopilación automatizada, el scraping o la creación de una copia de los datos devueltos.
Atribución requerida
Al mostrar datos nutricionales de Edamam a los usuarios finales, muestra la atribución requerida de Edamam y el enlace.
Salida informativa
Los resultados de nutrición y Vision deben presentarse como estimaciones para uso del producto, no como consejo médico o dietético.
Preguntas comunes de configuración.
¿Necesito claves de API de Edamam antes de conectar un cliente MCP?
Puedes conectarte al endpoint público de Food MCP y descubrir las herramientas disponibles primero. Para ejecutar llamadas reales a herramientas, necesitas un app_id y app_key de la Edamam Food Database API enviados como bearer token.
¿Cómo me suscribo a un plan de Food MCP?
Elige un plan de la Food Database API en la sección de precios o en el modal de registro, crea tu cuenta de API y luego inicia sesión para completar el siguiente paso de facturación para el acceso a la API.
¿El servidor almacena mis credenciales de Edamam?
No. Las llamadas de clientes públicos pasan las credenciales en el encabezado Authorization. Las implementaciones autoalojadas pueden establecer variables de entorno como credenciales de respaldo.
¿Por qué no hay una herramienta independiente search_food?
La implementación actual de FastMCP resuelve la búsqueda de alimentos internamente dentro de get_food_nutrition. Se puede añadir una herramienta separada solo de búsqueda más adelante si los flujos de trabajo de los usuarios necesitan resultados de tipo navegación.