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)

Configuración

1. Clonar el repositorio
2. Instalar dependencias:
   npm install
3. Construir 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:

Para desarrollo con recarga en caliente:

Uso con Claude Desktop

Para utilizar este servidor MCP con Claude Desktop:

1. 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..."
2. En el panel de Configuración, haga clic en "Desarrollador" en la barra de la izquierda y luego haga clic en "Editar configuración".
3. Esto creará o abrirá un archivo de configuración en:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Ventanas: %APPDATA%\Claude\claude_desktop_config.json
4. 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-server con 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.
5. Guarde el archivo de configuración y reinicie Claude Desktop
6. 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 ID
  • Pará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 entrada
  • Pará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 alimentos
  • Pará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 clave
  • Pará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:

Obtenga múltiples alimentos utilizando el recurso MCP:

Obtenga una lista de alimentos utilizando el recurso MCP:

Búsqueda de alimentos utilizando la herramienta MCP: