wacon-mcp
Health Uyari
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 5 GitHub stars
Code Uyari
- process.env — Environment variable access in .github/workflows/publish.yml
- network request — Outbound network request in scripts/build-cat-stickers.mjs
- process.env — Environment variable access in scripts/postinstall.mjs
- process.env — Environment variable access in scripts/smoke-package.mjs
Permissions Gecti
- Permissions — No dangerous permissions requested
Bu listing icin henuz AI raporu yok.
Permite a tus agentes leer, enviar, ordenar mensajes de whatsapp
Wacon
Tu WhatsApp, tu terminal, tus agentes de IA.
Lee conversaciones, organiza pendientes y prepara respuestas con memoria por contacto.
Instalación · Primeros pasos · Conectar un agente · Configuración · Desarrollo
El almacenamiento y el análisis básico funcionan en tu equipo. Las integraciones con modelos, voz y NotebookLM son opcionales.
Qué puedes hacer
| Capacidad | Para qué sirve | |
|---|---|---|
| 💬 | Conversaciones en la terminal | Leer, buscar, responder y abrir una interfaz de pantalla completa. |
| 🧠 | Memoria por contacto | Combinar hechos, notas de relación, estilo de escritura e historial relevante. |
| 🔌 | Herramientas MCP | Dar acceso a tus agentes a conversaciones, contexto, agenda y envíos. |
| 📥 | Bandeja y productividad | Revisar pendientes, compromisos detectados, tareas y eventos. |
| 🖼️ | Archivos y multimedia | Enviar documentos, imágenes, stickers y notas de voz con un backend configurado. |
| ⏱️ | Seguimiento de mensajes | Esperar novedades con filtros y long polling, sin consultar continuamente el historial. |
Instalación
Requiere Node.js 22.18.0 o superior (se recomiendan las LTS 22 o 24; la línea actual, 25/26, también funciona), npm y una cuenta de WhatsApp para vincular el dispositivo. No necesitas herramientas de compilación: el binario de SQLite viaja dentro del paquete npm y es independiente de la versión de Node.
Desde npm
npm install -g @josetra/wacon
wacon --version
El paquete se llama @josetra/wacon; el comando instalado es wacon.
Windows: si la instalación intenta compilar y falla buscando Python o Visual Studio, actualiza npm (
npm install -g npm@latest) y repite la instalación. Es un fallo conocido de npm 10 con binarios que ya vienen incluidos en el paquete; no necesitas instalar ninguna herramienta de compilación.
También puedes ejecutarlo sin instalación global:
npx -y @josetra/wacon login
Desde GitHub
Disponible para instalar directamente desde el código fuente:
npm install -g github:JOSETRA44/wacon-mcp
Esta vía requiere Git y compila el proyecto TypeScript durante la instalación. El binario nativo de SQLite ya viene dentro de su paquete npm (N-API), así que no hace falta un compilador de C++ en las plataformas habituales (Windows/macOS/Linux, x64 y arm64).
Primeros pasos
1. Vincula tu cuenta.
wacon login
En WhatsApp, abre Dispositivos vinculados → Vincular un dispositivo y escanea el QR de la terminal.
2. Comprueba la conexión y explora tus conversaciones.
wacon status
wacon chats
wacon inbox
3. Abre el cliente que prefieras.
wacon chat # Chat ligero
wacon chat ultra # Interfaz de pantalla completa
wacon tui # Alias de la interfaz de pantalla completa
4. Construye tu memoria de conversación.
Cuando el historial esté sincronizado:
wacon init # Analiza contactos
wacon init --all # Incluye grupos
wacon persona # Consulta tu perfil global
Revisa y edita ~/.wacon/persona.md: define tu voz y las reglas que deben seguir los agentes. Los hechos extraídos automáticamente son candidatos de baja confianza; conviene revisarlos antes de usarlos como contexto.
Conectar un agente
Claude Code
Con Wacon instalado globalmente:
claude mcp add wacon -- wacon mcp
O usando npx:
claude mcp add wacon -- npx -y @josetra/wacon mcp
Otros clientes MCP
Añade una entrada equivalente a la configuración de tu cliente:
{
"mcpServers": {
"wacon": {
"command": "npx",
"args": ["-y", "@josetra/wacon", "mcp"]
}
}
}
El formato exacto depende del cliente. Si en Windows necesita ejecutar npx a través del intérprete de comandos, utiliza "command": "cmd" y "args": ["/c", "npx", "-y", "@josetra/wacon", "mcp"].
También existe un endpoint HTTP local en http://127.0.0.1:8317/mcp. Requiere Authorization: Bearer <token>; el token de la sesión está en ~/.wacon/daemon.json.
Skills incluidas
El paquete contiene dos guías para agentes:
wacon-whatsapp: conversaciones, respuestas, archivos y seguimiento.wacon-knowledge: análisis, perfiles, hechos y memoria episódica.
wacon skills # Instala las skills sin sobrescribir las existentes
wacon skills --force # Actualiza las copias instaladas
wacon skills --target ./skills # Elige otro destino
Durante la instalación, Wacon intenta copiarlas a ~/.claude/skills/ si ya existe la configuración de Claude. Puedes omitir este paso con la variable de entorno WACON_SKIP_POSTINSTALL=1; también se omite en CI. El destino predeterminado se puede cambiar mediante WACON_SKILLS_DIR.
Uso cotidiano
Leer, buscar y responder
wacon contacts "Contacto"
wacon read "Contacto" --limit 20
wacon search "reunión"
wacon send "Contacto" "Confirmado, nos vemos a las cinco."
Los comandos de envío actúan sobre WhatsApp. Para ensayar sin enviar, activa dryRun en la configuración.
Revisar pendientes
wacon inbox
wacon brief
wacon commitments
wacon calendar --days 7
wacon tasks
Los compromisos y las sugerencias se extraen del historial; revísalos antes de tratarlos como acuerdos confirmados.
Analizar y recordar
wacon init --groups
wacon profile "Contacto"
wacon facts "Contacto"
wacon suggested
wacon suggested --confirm 12
Las sugerencias de eventos no se incorporan automáticamente a tu agenda: debes confirmarlas.
Archivos, stickers y voz
Dentro del chat ligero:
/send ./informe.pdf Aquí está el informe.
/send ./nota.ogg --voz
/voz Confirmado, nos vemos a las cinco.
Desde la terminal:
wacon stickers --sync
wacon voice "Contacto" "Confirmado, nos vemos a las cinco."
La síntesis de voz requiere un backend configurado. Los agentes disponen de herramientas como send_file, send_sticker y send_voice_message.
Seguimiento y automatización
wacon watch --minutes 30 --min-priority 40
wacon digest --minutes 60
wacon inbox --json
Para scripts y agentes, los comandos de datos admiten --json y evitan los códigos de color. Las herramientas MCP wait_for_messages y wait_for_triggers permiten esperar novedades y recordatorios. El daemon notifica los eventos; el agente decide cómo actuar.
Consulta todas las opciones con wacon --help o wacon <comando> --help.
Cómo funciona la memoria
Wacon combina tres fuentes de contexto:
| Fuente | Contenido |
|---|---|
| Perfil global | Tu voz y tus preferencias, editables en persona.md. |
| Perfil por contacto | Estadísticas de estilo y notas sobre la relación. |
| Hechos e historial | Datos estructurados, mensajes recuperados y resúmenes de episodios. |
La recuperación local combina búsqueda de texto, similitud por n-gramas y recencia. No necesita un servicio externo de embeddings. El análisis inicial usa reglas y estadísticas; un agente puede enriquecer o corregir sus resultados.
La herramienta MCP prepare_reply reúne el perfil, los hechos y el contexto relevante para preparar una respuesta.
Configuración
El directorio predeterminado es ~/.wacon/ (%USERPROFILE%\.wacon\ en Windows). Puedes cambiarlo con WACON_HOME.
~/.wacon/
├── auth/ Credenciales de la sesión de WhatsApp
├── profiles/ Perfiles por contacto
├── wacon.db Mensajes, hechos y agenda
├── persona.md Tu voz y reglas para agentes
├── config.json Preferencias y límites
├── notebooks.json Asociaciones con NotebookLM
└── daemon.json Información de conexión local
Ejemplo de config.json para probar los flujos sin realizar envíos:
{
"dryRun": true,
"sendRateLimitPerMinute": 10,
"allowedChats": [],
"blockedChats": [],
"daemonPort": 8317
}
dryRun: registra los intentos de envío sin enviarlos. Su valor predeterminado esfalse.allowedChats: si contiene JIDs, limita los envíos a esos chats.blockedChats: impide enviar a los JIDs indicados.sendRateLimitPerMinute: limita la frecuencia de envío.
Integraciones opcionales
| Integración | Configuración | Uso |
|---|---|---|
| Voz | tts con un endpoint compatible con OpenAI |
Convertir texto en notas de voz. |
| Transcripción | transcription con API compatible o whisper.cpp |
Convertir audio a texto. |
| Visión | vision con un endpoint compatible |
Describir imágenes mediante un modelo. |
| FFmpeg | Disponible en PATH o mediante ffmpegPath |
Convertir audio y preparar notas de voz. |
| NotebookLM | CLI nlm autenticado y notebooks.json |
Consultar fuentes asociadas a chats etiquetados. |
Estas integraciones se configuran según el proveedor que utilices. Las API externas pueden tener coste y recibir el contenido que les envíes. Sin una API de visión o transcripción configurada, las herramientas MCP pueden entregar imágenes o audio al cliente para que use sus propias capacidades multimodales.
Arquitectura y privacidad
Terminal / cliente MCP
│
▼
Daemon local de Wacon
├── Sesión de WhatsApp mediante Baileys
├── SQLite: mensajes, memoria y agenda
├── Perfiles Markdown
└── Integraciones opcionales
El daemon comparte una sesión entre clientes, escucha en 127.0.0.1 y requiere un token de acceso. Los mensajes, perfiles y análisis se almacenan localmente. Al conectar un agente o habilitar un servicio externo, el contenido solicitado puede ser procesado por ese cliente o proveedor.
Las credenciales de WhatsApp se guardan en el directorio auth/ sin cifrado adicional de Wacon. Protege ese directorio y no lo incluyas en repositorios ni archivos compartidos.
Diagnóstico
wacon doctor
wacon errors --tail 20
wacon daemon log
wacon doctor comprueba el estado local y las integraciones. Para reiniciar el daemon puedes usar wacon daemon-restart. Si necesitas volver a vincular la cuenta, revisa primero el diagnóstico y luego ejecuta wacon login.
Desarrollo
git clone https://github.com/JOSETRA44/wacon-mcp.git
cd wacon-mcp
npm ci
npm run check
npm link
| Comando | Función |
|---|---|
npm run dev |
Compilar al cambiar los archivos. |
npm run typecheck |
Verificar tipos de TypeScript. |
npm test |
Ejecutar la suite de pruebas. |
npm run build |
Generar los ejecutables en dist/. |
npm run check |
Ejecutar tipos, pruebas y compilación. |
Las notas de arquitectura y diseño están en wacon-docs. Para preparar una versión y configurar la publicación, consulta la guía de releases.
Para reportar un problema, incluye la versión de Wacon, Node.js, el sistema operativo y los pasos para reproducirlo en Issues. Elimina teléfonos, mensajes privados, tokens y credenciales de los registros que compartas.
Proyecto y licencia
Wacon es un proyecto independiente que usa Baileys para integrarse con WhatsApp. No es una aplicación oficial ni está afiliada a WhatsApp o Meta; el uso de clientes no oficiales puede afectar la disponibilidad de la cuenta.
Publicado bajo la licencia MIT. Los stickers incluidos derivan de Twemoji, con licencia CC BY 4.0; su atribución se conserva en el manifest del pack.
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi