wanderlog-mcp

Un servidor MCP que permite a Claude (o a cualquier agente compatible con MCP) ver y crear itinerarios de viaje en Wanderlog a través de una conversación.

En lugar de hacer clic en la interfaz de usuario de Wanderlog para planificar un viaje, simplemente pregunta:

"Crea un viaje de 14 días por la Ruta Dorada de Japón: Tokio, Hakone, Kioto, Nara y Osaka".

El agente llama a las herramientas, intercala lugares y notas para cada día, añade bloques de hoteles y listas de verificación, y en pocos minutos obtendrás un viaje de Wanderlog completamente configurado.

Mira un ejemplo real: Ruta Dorada de Japón de 14 días — creado íntegramente por un agente de IA utilizando este servidor MCP.

Novedades en la v0.1.0

• Creación completa de itinerarios: lugares, notas, hoteles y listas de verificación en una sola conversación

• wanderlog_search_places — encuentra lugares reales cerca de cualquier destino utilizando la base de datos de lugares de Wanderlog

• wanderlog_add_note — intercala consejos de transporte, información de reservas y recomendaciones locales entre los lugares

• wanderlog_add_checklist — listas de verificación previas al viaje y diarias (visados, moneda, entradas con horario)

• Instrucciones del servidor MCP inyectadas al inicio para que Claude cree itinerarios completos automáticamente

• Prueba de autenticación al inicio — detecta cookies caducadas inmediatamente en lugar de fallar a mitad de la conversación

Ejemplos de prompts

"What trips do I have in Wanderlog?"

"Create a 7-day itinerary for Lisbon starting June 1 — include restaurants, day trips,
and a hotel near the waterfront."

"Add a day trip to Sintra on day 3 of my Lisbon trip."

"I'm spending 5 days in Tokyo — build me a full itinerary with museum visits, ramen spots,
and a ryokan in Shinjuku."

"Look at my Barcelona trip and add practical notes for getting between each place."

"Add a pre-trip checklist to my Paris trip — visa, currency, offline maps, travel insurance."

"Move my Rome trip back by two weeks."

"Give me the shareable link to my Kyoto itinerary."

"Remove the Colosseum from day 2 of my Rome trip."

Herramientas

Requisitos previos

• Node.js 22 o superior

• Una cuenta de Wanderlog

• Un cliente compatible con MCP: Claude Code, Claude Desktop, OpenAI Codex, Cursor, VS Code o cualquier host MCP stdio

Configuración

Paso 1 — Obtén tu cookie de sesión de Wanderlog

Wanderlog no tiene una API pública, por lo que wanderlog-mcp se autentica utilizando la cookie de sesión de tu navegador (connect.sid). Es válida durante aproximadamente un año y nunca sale de tu máquina.

Trátala como una contraseña — otorga el mismo acceso que tienes en la interfaz de usuario de Wanderlog.

Chrome / Edge

1. Ve a wanderlog.com e inicia sesión

2. Presiona F12 para abrir las herramientas de desarrollador (DevTools)

3. Haz clic en la pestaña Application (Aplicación)

4. En la barra lateral izquierda, expande Storage → Cookies → https://wanderlog.com

5. Busca la fila donde el Name (Nombre) es connect.sid

6. Haz clic en la fila, luego haz doble clic en la celda Value (Valor) y copia la cadena completa — comienza con s%3A y tiene unos 100 caracteres de longitud

Firefox

1. Ve a wanderlog.com e inicia sesión

2. Presiona F12 para abrir las herramientas de desarrollador (DevTools)

3. Haz clic en la pestaña Storage (Almacenamiento)

4. En la barra lateral izquierda, expande Cookies → https://wanderlog.com

5. Busca connect.sid en la tabla, haz clic en ella y copia el Value (Valor)

¿Por qué no puedo usar document.cookie en la consola? Wanderlog establece connect.sid con la bandera HttpOnly, lo que bloquea deliberadamente la lectura por parte de JavaScript (protección XSS). Las herramientas de desarrollador omiten esta restricción; por eso funciona allí y no en la consola.

Paso 2 — Configura tu cliente MCP

Claude Code

claude mcp add wanderlog-mcp npx wanderlog-mcp \
  --env WANDERLOG_COOKIE="s%3A...your value here..."

Claude Desktop

Edita claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "wanderlog": {
      "command": "npx",
      "args": ["wanderlog-mcp"],
      "env": {
        "WANDERLOG_COOKIE": "s%3A...your value here..."
      }
    }
  }
}

Reinicia Claude Desktop después de guardar.

Cursor

Settings → MCP → Add server, o edita ~/.cursor/mcp.json:

{
  "mcpServers": {
    "wanderlog": {
      "command": "npx",
      "args": ["wanderlog-mcp"],
      "env": {
        "WANDERLOG_COOKIE": "s%3A...your value here..."
      }
    }
  }
}

VS Code (GitHub Copilot)

Añádelo a tu espacio de trabajo .vscode/mcp.json:

{
  "servers": {
    "wanderlog": {
      "type": "stdio",
      "command": "npx",
      "args": ["wanderlog-mcp"],
      "env": {
        "WANDERLOG_COOKIE": "s%3A...your value here..."
      }
    }
  }
}

OpenAI Codex

Edita ~/.codex/config.toml:

[mcp_servers.wanderlog]
command = "npx"
args = ["wanderlog-mcp"]

[mcp_servers.wanderlog.env]
WANDERLOG_COOKIE = "s%3A...your value here..."

Ejecuta /mcp dentro de Codex para confirmar que el servidor se cargó.

Smithery (instalación con un clic)

npx @smithery/cli install wanderlog-mcp --client claude

Paso 3 — Verificar

Pregunta a tu agente: "¿Qué viajes tengo en Wanderlog?"

Debería llamar a wanderlog_list_trips y devolver los viajes de tu cuenta. Si falla, consulta Solución de problemas a continuación.

Actualización de tu cookie

La cookie dura aproximadamente un año, pero puede caducar antes si cierras sesión en wanderlog.com, cambias tu contraseña o Wanderlog revoca la sesión. Cuando eso sucede, cada llamada a la herramienta devuelve:

Wanderlog session invalid or expired — Captura una nueva cookie connect.sid desde las herramientas de desarrollador de wanderlog.com y actualiza WANDERLOG_COOKIE en tu configuración de MCP.

Repite el Paso 1 anterior, actualiza tu configuración y reinicia tu cliente MCP.

Solución de problemas

El servidor se inicia pero list_trips devuelve un error de autenticación Tu cookie ha caducado o es incorrecta. Vuelve a capturarla desde las herramientas de desarrollador y actualiza tu configuración.

npx wanderlog-mcp se bloquea o no hace nada El servidor utiliza stdio MCP; está diseñado para ser iniciado por un host MCP, no para ejecutarse directamente en una terminal. Ejecútalo a través de Claude Code o Claude Desktop como se describió anteriormente.

Las herramientas funcionan pero el agente ignora las notas/listas de verificación El servidor inyecta instrucciones en la respuesta initialize de MCP que le dicen al agente que intercale lugares y notas y añada listas de verificación. Esto funciona de forma fiable con Claude. Otros clientes pueden variar.

Seguridad

• La cookie se almacena solo en la configuración de tu cliente MCP, nunca se confirma ni se registra

• wanderlog-mcp se ejecuta completamente en tu máquina; no hay servidor de retransmisión

• La prueba de autenticación al inicio valida tu cookie sin imprimir su valor

• Para revocar el acceso: cierra sesión en wanderlog.com (invalida todas las sesiones), luego vuelve a capturarla

Contribución

Las solicitudes de extracción (pull requests) son bienvenidas. Antes de enviar:

npm run build && npm run test

Para cambios en el transporte o el código de la herramienta, ejecuta también:

npm run test:integration

Descargo de responsabilidad

wanderlog-mcp es una herramienta de terceros no oficial, no afiliada ni respaldada por Wanderlog. Funciona llamando a la API privada del cliente web de Wanderlog, que puede cambiar sin previo aviso. Úsalo bajo tu propio riesgo.

Licencia

MIT — ver LICENSE

Creado por shaikhspeare