DEPLOY.md•7.91 kB
# Deployment Guide
Guía completa para desplegar el servidor MCP de Superprecio.
## Pre-requisitos
- ✅ Código compilado exitosamente
- ✅ Tests pasando (opcional)
- ✅ Cuenta en GitHub
- ✅ Cuenta en npmjs.com (para publicar en npm)
- ✅ Git instalado
- ✅ GitHub CLI instalado (opcional, recomendado)
## Paso 1: Verificar que todo funciona
```bash
# Compilar
npm run build
# Probar conexión (requiere Superprecio corriendo)
npm test
# Verificar que no hay errores de TypeScript
npx tsc --noEmit
```
## Paso 2: Inicializar Git
```bash
# En el directorio del proyecto
cd /Users/diegopacheco/Development/superprecio_mcp
# Inicializar git
git init
# Verificar que .gitignore está funcionando
git status
# No deberías ver:
# - node_modules/
# - build/ (aunque en este caso queremos incluirlo en npm, no en git)
# - .env
```
## Paso 3: Primer Commit
```bash
# Agregar todos los archivos
git add .
# Verificar qué se va a commitear
git status
# Crear el commit
git commit -m "Initial commit: Superprecio MCP Server v1.0.0
Features:
- 6 MCP tools for price comparison
- HTTP client for Superprecio API
- Resources for supermarket data
- Price expert prompt
- Complete documentation in Spanish
- TypeScript with full type safety
Tools:
- search_products: Search by name/description
- search_by_code: Search by EAN/barcode
- compare_prices: Compare prices across stores
- get_best_deals: Find current deals and discounts
- send_notification: Push notifications
- subscribe_device: Subscribe to price alerts
Architecture:
- HTTP client wrapper over Superprecio REST API
- Modular design for easy extension
- Error handling and debug mode
- Environment-based configuration
Ready for:
- GitHub publication
- npm publication
- Claude Desktop integration"
```
## Paso 4: Crear Repositorio en GitHub
### Opción A: Con GitHub CLI (Recomendado)
```bash
# Crear repositorio público
gh repo create superprecio_mcp \
--public \
--source=. \
--remote=origin \
--description="MCP Server for Superprecio - AI-powered price comparison for Argentina" \
--push
# O privado si prefieres
gh repo create superprecio_mcp \
--private \
--source=. \
--remote=origin \
--description="MCP Server for Superprecio - AI-powered price comparison for Argentina" \
--push
```
### Opción B: Manualmente
1. Ve a https://github.com/new
2. Repository name: `superprecio_mcp`
3. Description: "MCP Server for Superprecio - AI-powered price comparison for Argentina"
4. Público o Privado (según prefieras)
5. NO marques: Initialize with README, .gitignore, license (ya los tenemos)
6. Click "Create repository"
Luego:
```bash
# Configurar remote
git remote add origin https://github.com/bunkerapps/superprecio_mcp.git
# Cambiar a main branch
git branch -M main
# Push
git push -u origin main
```
## Paso 5: Configurar GitHub Repository
### Topics
Ve a tu repositorio en GitHub y agrega estos topics:
```
mcp
model-context-protocol
claude
anthropic
price-comparison
argentina
latin-america
supermarket
typescript
nodejs
ai-assistant
```
### About Section
- Description: "MCP Server for Superprecio - AI-powered price comparison for Argentina"
- Website: URL de Superprecio si tienes
- Topics: (los de arriba)
### Repository Settings
- ✅ Issues: Habilitado
- ✅ Discussions: Opcional
- ✅ Projects: Opcional
## Paso 6: Publicar en npm
### Preparación
```bash
# Login en npm
npm login
# Verificar que estás logueado
npm whoami
```
### Verificación pre-publicación
```bash
# Ver qué archivos se incluirán
npm pack --dry-run
# Deberías ver principalmente:
# - build/
# - package.json
# - README.md
# - LICENSE
```
### Primera Publicación
```bash
# Publicar
npm publish --access public
# Si todo sale bien, verás:
# + superprecio-mcp@1.0.0
```
### Verificar Publicación
```bash
# Ver el paquete en npm
npm view superprecio-mcp
# Probar instalación
npx superprecio-mcp --version
```
## Paso 7: Crear Release en GitHub
```bash
# Crear tag
git tag -a v1.0.0 -m "Release v1.0.0
Initial release with:
- 6 MCP tools
- Superprecio API integration
- Complete documentation
"
# Push tag
git push origin v1.0.0
```
En GitHub:
1. Ve a "Releases"
2. Click "Draft a new release"
3. Choose tag: v1.0.0
4. Title: "v1.0.0 - Initial Release"
5. Description: (copia del tag message)
6. Click "Publish release"
## Paso 8: Actualizar URLs en README
Ahora que tienes el repositorio, actualiza el README.md con las URLs reales:
```bash
# Edita README.md y reemplaza:
# - https://github.com/bunkerapps/superprecio_mcp
# - https://superprecio.ar (Superprecio API)
# Por tus URLs reales
```
Commit los cambios:
```bash
git add README.md
git commit -m "Update README with real GitHub URLs"
git push
```
## Paso 9: Agregar Badges al README
Agrega estos badges al inicio del README.md:
```markdown
# Superprecio MCP Server
[](https://www.npmjs.com/package/superprecio-mcp)
[](https://opensource.org/licenses/MIT)
[](https://www.typescriptlang.org/)
[](https://nodejs.org/)
```
## Paso 10: Promocionar el Proyecto
### Model Context Protocol Registry
Agrega tu servidor al registro oficial:
https://github.com/modelcontextprotocol/servers
Fork el repo y agrega tu servidor a la lista.
### Redes Sociales
Tweet/Post:
```
🚀 Introducing Superprecio MCP Server!
Transform Claude into an Argentina price comparison expert 🇦🇷
✅ Search products across supermarkets
✅ Compare prices instantly
✅ Find best deals
✅ Save money on groceries
npm: npx superprecio-mcp
#MCP #Claude #AI #Argentina
https://github.com/bunkerapps/superprecio_mcp
```
### Comunidad Anthropic/Claude
- Post en foros de Claude
- Discord de Anthropic
- Reddit: r/ClaudeAI
## Paso 11: Futuras Actualizaciones
### Workflow para Updates
1. Hacer cambios en el código
2. Compilar y probar
3. Actualizar versión en package.json
```bash
# Para bug fixes
npm version patch # 1.0.0 -> 1.0.1
# Para nuevas features
npm version minor # 1.0.0 -> 1.1.0
# Para breaking changes
npm version major # 1.0.0 -> 2.0.0
```
4. Commit y push
```bash
git add .
git commit -m "Bump version to X.X.X"
git push
git push --tags
```
5. Publicar en npm
```bash
npm publish
```
6. Crear release en GitHub
## Checklist de Deployment
### Pre-Deployment
- [ ] Código compilado sin errores
- [ ] Tests pasando (si tienes)
- [ ] README actualizado
- [ ] CHANGELOG creado (opcional)
- [ ] Version number correcto en package.json
### GitHub
- [ ] Repositorio creado
- [ ] Código pusheado
- [ ] Topics agregados
- [ ] Description configurada
- [ ] Issues habilitados
### npm
- [ ] Cuenta creada
- [ ] Login exitoso
- [ ] Paquete publicado
- [ ] Instalación probada con npx
### Documentation
- [ ] README con URLs reales
- [ ] Badges agregados
- [ ] QUICK_START.md verificado
- [ ] Ejemplos funcionando
### Promotion
- [ ] Agregado a MCP registry
- [ ] Post en redes sociales
- [ ] Compartido en comunidades
## Troubleshooting
### "npm publish" falla
```bash
# Verifica que estás logueado
npm whoami
# Verifica que el nombre no existe
npm view superprecio-mcp
# Si existe, cambia el nombre en package.json
```
### Git push falla
```bash
# Verifica remote
git remote -v
# Re-configura si es necesario
git remote set-url origin https://github.com/bunkerapps/superprecio_mcp.git
```
### Build falla en npm install
```bash
# Limpia todo
rm -rf node_modules build package-lock.json
# Reinstala
npm install
```
## Soporte Post-Deployment
- Monitorea GitHub Issues
- Responde a feedback de usuarios
- Actualiza documentación según necesidad
- Mantén el paquete actualizado con Superprecio
---
¡Listo para deployment! 🚀