invoice-processor-mcp/NPM_UPLOAD_GUIDE.md

MCP server para procesar facturas en formato Excel

# Guía para Publicar en NPM

Esta guía te ayudará a publicar el paquete `invoice-processor-mcp` en npm, el registro de paquetes de Node.js.

## Requisitos Previos

1. Tener una cuenta en npm. Si no tienes una, regístrate en [npm website](https://www.npmjs.com/signup).
2. Tener instalado Node.js y npm en tu equipo.

## Paso 1: Preparar el paquete

Ya he preparado todos los archivos necesarios para la publicación:

- Actualizado `package.json` con toda la información necesaria
- Creado `.npmignore` para excluir archivos innecesarios
- Actualizado `README.md` con instrucciones de instalación y uso
- Creado script `publish-npm.js` para facilitar la publicación

## Paso 2: Verificar los archivos a publicar

Comprueba qué archivos se incluirán en el paquete usando el siguiente comando:

```bash
npm pack --dry-run
```

Esto te mostrará una lista de todos los archivos que se incluirán en el paquete sin realmente crear el archivo .tgz.

## Paso 3: Iniciar sesión en npm

Inicia sesión en tu cuenta de npm con:

```bash
npm login
```

Sigue las instrucciones en pantalla. Te pedirá:
- Nombre de usuario
- Contraseña
- Email
- Posiblemente un código de autenticación de dos factores (si lo tienes activado)

## Paso 4: Publicar el paquete utilizando nuestro script

Utiliza el script de publicación que he creado:

```bash
npm run publish-npm
```

El script te guiará a través de los siguientes pasos:
1. Actualizar el nombre del autor (opcional)
2. Actualizar la versión del paquete (opcional)
3. Publicar el paquete en npm

## Paso 5: Publicación manual (alternativa)

Si prefieres publicar manualmente, puedes usar:

```bash
npm publish
```

## Paso 6: Verificar la publicación

Una vez publicado, puedes verificar que el paquete esté disponible visitando:

```
https://www.npmjs.com/package/invoice-processor-mcp
```

## Consideraciones importantes

- **Nombre del paquete**: Asegúrate de que el nombre en `package.json` sea único y no esté ya tomado en npm.
- **Privacidad**: Por defecto, los paquetes se publican como públicos. Si quieres un paquete privado, necesitas una suscripción a npm.
- **Versionado**: Sigue el versionado semántico (SemVer): incrementa el parche para correcciones, la versión menor para funcionalidades nuevas compatible con versiones anteriores, y la versión mayor para cambios que rompen la compatibilidad.

## Para futuras actualizaciones

Para publicar nuevas versiones del paquete:

1. Actualiza el código según sea necesario
2. Incrementa la versión en `package.json` (puedes usar `npm version patch|minor|major`)
3. Ejecuta `npm publish` o `npm run publish-npm`

## Solución de problemas comunes

- **Error 403 al publicar**: Verifica que el nombre del paquete no esté ya en uso.
- **Error 401 unauthorized**: Verifica tus credenciales de npm con `npm whoami`.
- **Error de alcance del paquete**: Si estás intentando publicar bajo un alcance de organización (@tuorganizacion/tu-paquete), asegúrate de tener permisos en esa organización.

## Recursos adicionales

- [Documentación oficial de npm publish](https://docs.npmjs.com/cli/v8/commands/npm-publish)
- [Guía de creación de paquetes npm](https://docs.npmjs.com/creating-and-publishing-unscoped-public-packages)