mcp-open-food-facts
Version:
MCP server to use Open Food Facts API
138 lines (101 loc) • 3.37 kB
Markdown
# MCP Open Food Facts Server
[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