QUICK_START.md•4.86 kB
# Quick Start Guide
Guía rápida para poner en marcha el servidor MCP de Superprecio.
## 1. Prerequisitos
Asegúrate de tener:
- ✅ Node.js 18+ instalado
- ✅ Superprecio corriendo en http://localhost:3000 (o tu URL configurada)
- ✅ Claude Desktop instalado (para testing)
## 2. Instalación Local (Desarrollo)
```bash
# Navega al directorio del proyecto
cd /Users/diegopacheco/Development/superprecio_mcp
# Ya compilado con npm install, pero si necesitas recompilar:
npm run build
# Crear archivo .env
cp .env.example .env
# Edita .env con tu configuración
# SUPERPRECIO_API_URL=http://localhost:3000
```
## 3. Verificar que Superprecio está corriendo
```bash
# Prueba que la API responde
curl http://localhost:3000/api/products \
-H "Content-Type: application/json" \
-d '{"search": "arroz", "maxResults": 3, "order": "OrderByPriceASC"}'
```
Si esto devuelve resultados JSON, estás listo!
## 4. Configurar Claude Desktop
### macOS
Edita: `~/Library/Application Support/Claude/claude_desktop_config.json`
```json
{
"mcpServers": {
"superprecio": {
"command": "node",
"args": [
"/Users/diegopacheco/Development/superprecio_mcp/build/index.js"
],
"env": {
"SUPERPRECIO_API_URL": "http://localhost:3000"
}
}
}
}
```
### Windows
Edita: `%APPDATA%/Claude/claude_desktop_config.json` con la misma configuración (ajusta la ruta).
## 5. Reiniciar Claude Desktop
1. Cierra completamente Claude Desktop
2. Ábrelo de nuevo
3. El servidor MCP se conectará automáticamente
## 6. Probar el Servidor
En Claude Desktop, prueba estos comandos:
### Búsqueda Simple
```
Busca "arroz integral"
```
Claude debería usar el tool `search_products` automáticamente.
### Comparación de Precios
```
Compara el precio de "leche descremada" en todos los supermercados
```
Claude usará `compare_prices`.
### Mejores Ofertas
```
¿Cuáles son las mejores ofertas en cereales?
```
Claude usará `get_best_deals`.
### Usar el Prompt de Experto
```
Use the price_expert prompt
```
Claude se transformará en un asistente experto en compras de Argentina.
## 7. Ver los Tools Disponibles
En Claude Desktop, puedes escribir:
```
What MCP tools do you have access to?
```
Deberías ver:
- search_products
- search_by_code
- compare_prices
- get_best_deals
- send_notification
- subscribe_device
## 8. Ver los Resources
```
What MCP resources are available?
```
Deberías ver:
- supermarket://list
## 9. Debugging
### Ver logs del servidor
Los logs se muestran en stderr. En macOS:
```bash
# Ver logs de Claude Desktop
tail -f ~/Library/Logs/Claude/mcp*.log
```
### Habilitar debug mode
En tu configuración de Claude Desktop, agrega:
```json
{
"mcpServers": {
"superprecio": {
"command": "node",
"args": ["/Users/diegopacheco/Development/superprecio_mcp/build/index.js"],
"env": {
"SUPERPRECIO_API_URL": "http://localhost:3000",
"DEBUG": "true"
}
}
}
}
```
### Probar el servidor manualmente
```bash
# Ejecuta el servidor directamente
node build/index.js
```
Si hay errores de conexión, verás:
```
⚠️ Warning: Could not connect to Superprecio API
Check that the API is running at: http://localhost:3000
```
Si todo está bien:
```
✓ Connected to Superprecio API
Superprecio MCP Server running on stdio
```
## 10. Problemas Comunes
### "Could not connect to Superprecio API"
**Solución:**
```bash
# Verifica que Superprecio esté corriendo
curl http://localhost:3000
# Si no responde, inicia Superprecio:
cd /Users/diegopacheco/Development/superprecio
npm run dev
```
### "Unknown tool" al usar Claude
**Solución:**
1. Verifica que Claude Desktop esté completamente reiniciado
2. Verifica que la ruta en `claude_desktop_config.json` sea correcta
3. Verifica que el build existe: `ls build/index.js`
### TypeScript errors al compilar
**Solución:**
```bash
# Limpia y reconstruye
rm -rf build node_modules
npm install
npm run build
```
## 11. Siguiente Paso: GitHub y npm
Una vez que todo funcione localmente, sigue `GITHUB_SETUP.md` para:
- Publicar en GitHub
- Publicar en npm
- Compartir con la comunidad
## 12. Ejemplos de Uso Avanzado
### Búsqueda con filtros específicos
```
Busca arroz, máximo 5 resultados por supermercado, ordenado por precio ascendente
```
Claude interpretará esto y usará los parámetros correctos.
### Lista de compras
```
Necesito comprar:
- 2kg de arroz
- 1L de aceite
- 500g de frijoles
¿En qué supermercado me conviene comprar todo?
```
Claude buscará cada producto y te recomendará la mejor opción.
### Presupuesto
```
Tengo ₡10,000 para comprar comida. ¿Qué me recomiendas?
```
Claude te ayudará a optimizar tu presupuesto.
---
¡Listo! Ahora tienes un asistente AI experto en precios de supermercados de Argentina 🇦🇷