# MCP Open Food Facts Server

![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)
![License](https://img.shields.io/badge/license-MIT-green.svg)
![TypeScript](https://img.shields.io/badge/TypeScript-5.0.4-blue.svg)
![Node.js](https://img.shields.io/badge/Node.js-18.x-green.svg)

[Versión en Inglés](README_ES.md)


Un servidor MCP (Model Context Protocol) que proporciona acceso a la API de Open Food Facts, permitiendo búsquedas y consultas de información nutricional de productos alimenticios.

## 🚀 Características

- Búsqueda de productos por nombre
- Búsqueda de productos por código de barras
- Obtención de información detallada de productos
- Integración con el protocolo MCP
- Soporte para TypeScript

## 📋 Prerrequisitos

- Node.js (versión 18 o superior)
- npm o yarn
- TypeScript

## 🔧 Instalación

1. Clona el repositorio:
```bash
git clone https://github.com/PayCode-Studio/mcp-open-food-facts
cd mcp-open-food-facts
```

2. Instala las dependencias:
```bash
npm install
# o
yarn install
```


## 🚀 Uso

### Desarrollo

Para ejecutar el servidor en modo desarrollo:
```bash
npm run dev
# o
yarn dev
```

### Producción

Para construir y ejecutar en producción:
```bash
npm run build
npm start
# o
yarn build
yarn start
```

## 📦 Estructura del Proyecto

```
mcp-open-food-facts/
├── src/
│   ├── index.ts              # Punto de entrada de la aplicación
│   ├── services/             # Servicios de la aplicación
│   │   └── open-food-facts.services.ts
│   └── types/               # Definiciones de tipos TypeScript
│       ├── mcp.type.ts
│       └── open-food-facts.type.ts
├── dist/                    # Código compilado
├── package.json
├── tsconfig.json
└── README.md
```

## 🔍 API

### Búsqueda de Productos

#### Búsqueda por Nombre
```typescript
const products = await searchProduct("coca cola");
```

#### Búsqueda por Código de Barras
```typescript
const product = await getProductByBarcode("5449000000996");
```

### Respuesta

La API devuelve información detallada sobre los productos, incluyendo:
- Información nutricional
- Ingredientes
- Alérgenos
- Marca
- Categorías
- Puntuación ecoscore
- Y más...

## 🤝 Contribución

1. Fork el proyecto
2. Crea una rama para tu feature (`git checkout -b feature/AmazingFeature`)
3. Commit tus cambios (`git commit -m 'Add some AmazingFeature'`)
4. Push a la rama (`git push origin feature/AmazingFeature`)
5. Abre un Pull Request

## 📝 Licencia

Este proyecto está bajo la Licencia ISC. Ver el archivo `LICENSE` para más detalles.

## ✨ Autor

**cisco_juan** - *Trabajo Inicial* - [cisco_juan](https://github.com/cisco_juan)

## 🙏 Agradecimientos

- [Open Food Facts](https://world.openfoodfacts.org/) por proporcionar la API
- [Model Context Protocol](https://github.com/modelcontextprotocol) por el framework MCP
- Todos los contribuidores que participan en este proyecto

## 📞 Soporte

Si tienes alguna pregunta o problema, por favor:
1. Revisa los issues existentes
2. Abre un nuevo issue si es necesario
3. Contacta al equipo de mantenimiento

---

Hecho con ❤️ por la comunidad de desarrolladores