hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Integrations
Enables reading from custom feeds, getting mentions, posting articles, replying to posts, and adding likes to content on Bluesky SNS
Provides virtual travel capabilities including location setting, navigation, journey planning, and retrieving information about destinations and nearby facilities
Retrieves Street View photos of locations which can be combined with generated avatars to create immersive travel imagery
Entorno de bot de viaje virtual para MCP
Inglés / Japonés
Este es un servidor MCP que crea un entorno para que un avatar viaje virtualmente en Google Maps.
Desde un cliente MCP como Claude Desktop, puedes dar instrucciones al avatar e informar sobre el progreso de su recorrido con fotos.
Ahora es compatible con LibreChat https://www.librechat.ai/ .
Funciones
Función de herramientas del servidor MCP
Las siguientes funciones se pueden utilizar como servidor MCP. Las funciones disponibles varían según la configuración y el estado de ejecución.
Puede especificar el nombre de la función directamente, pero Claude LLM lo reconocerá automáticamente, por lo que puede especificar la operación en términos generales.
Ejemplo: "¿Dónde estás ahora?" "Vámonos a la estación de Tokio".
- obtener_información_de_vista_del_viajero(incluirFoto:booleano,incluirInstalacionesCercanas:booleano)
Obtiene información sobre la ubicación del avatar de viaje actual.- includePhoto: Obtiene fotos cercanas de Google Street View. Si has configurado una IA para generar imágenes, esta sintetizará el avatar.
- includeNearbyFacilities: obtiene información sobre las instalaciones cercanas.
- obtener_ubicación_del_viajero()
Obtiene información sobre la dirección del avatar de viaje actual y las instalaciones cercanas. - reach_a_percentage_of_destination() Alcanzar un porcentaje específico del destino (moveMode=solo omitir) timeElapsedPercentage: Porcentaje de progreso hacia el destino (0~100)
- set_traveler_location(dirección: cadena)
Establece la ubicación del avatar de viaje actual.- dirección: Información de la dirección (dirección exacta o nombre general que Google Maps o Claude puedan reconocer, etc.)
- obtener_la_dirección_de_destino_del_viajero
Obtén el destino del avatar de viaje que configures - set_traveler_destination_address(dirección: cadena)
Establecer el destino del avatar de viaje- dirección: Información de la dirección (dirección exacta o nombre general que Google Maps o Claude puedan reconocer, etc.)
- inicio_viaje_del_viajero
Comienza el viaje en el destino.(moveMode=solo en tiempo real) - detener el viaje del viajero
Detén el viaje.(moveMode=solo en tiempo real) - set_traveler_info(configuración:cadena)
Establezca los atributos del viajero. Configure la personalidad del viajero que desea cambiar dinámicamente, como el nombre y la personalidad. Sin embargo, si usa un script de rol, este es más estable.- Configuración: Configuración de información como nombre y personalidad.
- obtener información del viajero
Conoce los atributos del viajero. Conoce su personalidad. - set_avatar_prompt(mensaje:cadena)
Configura el mensaje al generar la imagen del avatar de viaje. El valor predeterminado es una mujer de estilo anime. Este estilo se aplica para evitar imágenes falsas.- inmediato
- mensaje de reinicio de avatar
Restablecer las indicaciones de generación de avatar a los valores predeterminados. - obtener feeds de SNS
Obtiene artículos de Bluesky SNS para la fuente personalizada especificada (fuentes que contienen una etiqueta específica). - obtener_menciones_sns
Obtiene menciones recientes (me gusta, respuestas) a las publicaciones de Bluesky SNS que usted mismo realizó. - post_sns_writer(mensaje:cadena)
Publica un artículo en la red social Bluesky con el feed personalizado especificado. Establece una etiqueta específica para determinar que la publicación fue generada por el bot de viajes.- mensaje: artículo
- reply_sns_writer(mensaje:cadena,id:cadena)
Responda al artículo con el ID especificado. Establezca una etiqueta específica para determinar que la publicación fue generada por el bot de viajes.- mensaje: responder
- id: El ID de la publicación a la que responder
- add_like(id:cadena)
Añade un me gusta a la publicación especificada.- id: El ID de la publicación a la que le darás me gusta
- consejos
Le guía sobre cómo configurar funciones que aún no se han configurado. - obtener_configuración
Obtener la configuración del entorno y de la imagen.
Recursos de MCP
Incluye cinco ejemplos de mensajes personalizados. Al importar un mensaje con Claude Desktop, Claude actuará como un viajero. La versión compatible con redes sociales controla la entrada y salida de mensajes mientras se mantiene una conversación de viaje.
- rol.txt
Claude actuará como viajero. - rolConSns.txt
Claude actuará como viajero. También controla la lectura y publicación en redes sociales. - carBattle.txt
Este es un pequeño juego novedoso sobre la historia del transporte de documentos secretos de Yokohama a Tokio. Las escenas se generan automáticamente. Configura moveMode=skip para jugar. - japanMapChallenge.txt,japanMapChallenge2.txt
Dos IA se comunican entre sí a través de redes sociales y juegan un juego de desafío utilizando imágenes de paisajes.
Para jugar, necesitas dos cuentas de Bluesky y dos escritorios Claude. También configura moveMode=skip. (Sin embargo, el funcionamiento es algo inestable).
japanMapChallenge2 tiene una regla de reflexión de desafío.
Configuración
Necesitará obtener y configurar claves de acceso para varias API, como acceder a varios mapas de Google y generar imágenes. El uso de la API puede conllevar cargos.
Configuración para usar con Claude Desktop
claude_desktop_config.json
NOTA: Las variables de entorno se han renombrado con el formato estándar de Snake. Se añade el prefijo MT_ porque pueden usarse junto con otras variables de entorno, como en LibreChat. Los nombres antiguos se pueden seguir usando por compatibilidad con versiones anteriores.
Configure las siguientes tres credenciales para la API de Google Maps.
- API estática de Street View
- API de lugares (Nueva)
- API de zona horaria
- API de direcciones
https://developers.google.com/maps/documentation/streetview/get-api-key
Si desea usar la IA de generación de imágenes, configure pixAi_key o sd_key. También necesita tener instalado Python 3.7-3.11 en su PC y la CLI de rembg (se recomienda un entorno virtual).
https://platform.pixai.art/docs\ https://platform.stability.ai/docs/api-reference#tag/SDXL-1.0-and-SD1.6/operation/textToImage
La dirección y contraseña de Bluesky SNS son opcionales. Se recomienda crear una cuenta dedicada, ya que se publicará automáticamente.
También puede ejecutarlo en modo de práctica, que no requiere una clave API para la verificación.
Configuración del modo de práctica
claude_desktop_config.json
Cómo utilizar
Utilice el modo de práctica
- Instalar nodejs 22.
- Configurar Claude Desktop para su uso.
- Refleje una de las configuraciones anteriores en claude_desktop_config.json.
- Reinicie Claude Desktop. La configuración puede tardar un poco (si se produce un error, intente reiniciar Claude Desktop de nuevo. Si no funciona, consulte las notas a continuación). Asegúrese de que aparezca la siguiente marca en la esquina inferior derecha de la pantalla.
- Pregunta "¿Dónde estás ahora?" y "Embárcate en un viaje". Se iniciará una conversación. Al usar la API, aparecerá una pantalla de confirmación; selecciona "Permitir".
- Seleccione Adjuntar desde MCP y seleccione role.txt.
- Se ha incorporado un aviso de viaje, así que no dudes en hablar con él.
Utilice la función completa
- Obtén una clave de acceso a la API de Google Maps y configura los permisos para la API estática de Street View, la API de Places (Nueva), la API de zona horaria y la API de indicaciones. Configúrala en el entorno de claude_desktop_config.json y reinicia. En este punto, el registro de viaje se basará en el mapa real. También se mostrarán imágenes de viaje si no están superpuestas.
- Elija una ruta que no interfiera con el disco y configúrela en sqlite_path del entorno de claude_desktop_config.json. (Ejemplo: %USERPROFILE%/Desktop/traveler.sqlite $HOME/Documents/traveler.sqlite, etc.) En este punto, se guardará su registro de viaje y podrá continuar su viaje incluso si cierra Claude Desktop.
- Instale Python 3.7 a 3.11 e instale rembg con CLI. Recomendamos usar un entorno virtual como venv.
Comprueba si rembg CLI funciona correctamente con un archivo de imagen de muestra. Introduce una imagen con una persona y, si esta aparece recortada en el archivo de salida, no hay problema.
- La CLI de rembg se instalará en la ubicación del archivo exe de Python, así que obtenga la ruta. La ubicación del archivo varía según el sistema operativo y el estado de instalación de Python, pero en el caso de venv, es (nombre del entorno virtual)\Scripts\rembg.exe o (nombre del entorno virtual)/bin/rembg, encima del directorio que haya configurado. Si no la encuentra, busque la ruta con un buscador de archivos. Establezca esa ruta como rembg_path del entorno en claude_desktop_config.json. (Ejemplo: "rembg_path": "C:\Users\xxxx\Documents\rembg_venv\venv\Scripts\rembg.exe")
- Obtén una clave API para generar imágenes desde el sitio web de pixAI o Stability.ai. Establece la clave en pixAi_key o sd_key en el entorno de claude_desktop_config.json. El avatar se superpondrá a la imagen del viaje.
- Obtén la dirección/contraseña y el nombre del usuario de Bluesky SNS. Establécelos en bs_id, bs_pass y bs_handle en el entorno de claude_desktop_config.json, respectivamente. Importa el aviso de información de viajes roleWithSns.txt para informar sobre las acciones de viaje a SNS (se publicará automáticamente como un bot, por lo que recomendamos asignar una cuenta dedicada).
En lugar de preparar rembg con la CLI, hemos agregado una configuración que le permite manejar rembg como una API de servicio.
Si configura el siguiente servicio rembg, puede usar rembg configurando la URL en remBgUrl.
https://github.com/danielgatis/rembg?tab=readme-ov-file#rembg-s
La configuración es sencilla si usa la versión Docker para iniciar un contenedor y acceder a él.
https://github.com/danielgatis/rembg?tab=readme-ov-file#usage-as-a-docker
Al utilizar ComfyUI externo (para usuarios más avanzados)
También puede usar un ComfyUI local como servidor de generación de imágenes. Puede configurar usted mismo las características de generación de imágenes detalladamente para reducir los costos de la API.
Sin embargo, la configuración será bastante complicada y la generación de imágenes puede tardar más tiempo.
- Configure ComfyUI para que se ejecute en modo API.
- Establezca la URL del servidor en comfy_url en env.
- Establezca valores de configuración detallados, como el modelo que se utilizará en env, en forma de una cadena json, ejemplo.
- El flujo de trabajo predeterminado puede usar assets/comfy/t2i_sample.json y assets/comfy/i2i_sample.json en el paquete. Puede especificar variables usando % y especificarlas en comfy_params.
Usando libreChat
Se ha adaptado para funcionar con libreChat. Esto facilita su uso, pero requiere algunas configuraciones adicionales.
Además, parece que no será estable a menos que la PC que uses tenga un nivel de rendimiento decente, como una que pueda ejecutar Docker de manera estable.
Instalar libreChat
Asegúrese de que funcione como se describe en el sitio web oficial.
En este caso, recomendamos utilizar la configuración de Docker debido a configuraciones adicionales.
https://www.librechat.ai/docs/local/docker
Configure librechat.yaml utilizando el procedimiento oficial.
Creo que necesitarás agregar un servicio LLM local o API.
https://www.librechat.ai/docs/configuration/librechat\_yaml
Añadir un usuario para iniciar sesión.
https://www.librechat.ai/docs/configuration/authentication#create-user-script
Configúrelo para que pueda tener conversaciones de chat generales.
Agregue un contenedor rembg con configuraciones adicionales
Para usar rembg con Docker, agregue la extracción y ejecución del contenedor Docker rembg.
docker-compose.override.yml
Agregar map-traveler-mcp al servicio MCP
Agregar librechat.yaml
Agregar .env (igual que env en claude_desktop_config.json)
Después de la configuración, reinicie el contenedor.
En PC lentas, la inicialización de mcp puede fallar. Reiniciar varias veces puede funcionar, pero puede ser difícil.
Configuración de llibreChat
Para utilizar la función MCP en libreChat, utilice la función Agentes.
- En la pantalla de conversación, seleccione Agentes.
- Seleccione Agent Builder en el panel del lado derecho de la pantalla y configure su agente.
- Seleccione Agregar herramientas para utilizar map-traveler.
- Aparecerá la pantalla de herramientas del agente, así que seleccione y agregue todas las herramientas map-traveler-mcp (si las herramientas map-traveler-mcp no están en la lista, la inicialización de MCP ha fallado, así que reinicie el contenedor o revise la configuración verificando los registros, etc.)\ \
- Introduzca un script adicional en el área de instrucciones.
Dado que libreChat no tiene la función de recurso MCP, ingrese el texto del contenido de la siguiente URL en el área de instrucciones.
https://github.com/mfukushim/map-traveler-mcp/blob/main/assets/scenario/role.txt\ - Haga clic en el botón Crear para guardar el agente.
- Iniciar un nuevo chat.
Guía de instalación (en japonés, pero con muchas fotos)
- Introducción y modo de práctica
https://note.com/marble\_walkers/n/n7a8f79e4fb30 - Base de datos, API de Google Maps, API de generación de imágenes
https://note.com/marble\_walkers/n/n765257c27f3b - Aviso de avatar
https://note.com/marble\_walkers/n/nc7273724faea - Integración de redes sociales
https://note.com/marble\_walkers/n/na7c956befe7b - Solicitud 1
https://note.com/marble\_walkers/n/n3c86edd8e817 - API de ComfyUI
https://note.com/marble\_walkers/n/ncefc7c05d102 - Solicitud 2
https://note.com/marble\_walkers/n/ne7584ed231c8 - Configuración de LibreChat
https://note.com/marble\_walkers/n/n339bf7905324
Más información sobre el código fuente
Utilizo Effect.ts para simplificar la gestión de errores y para mi propio aprendizaje.
También utilizamos el Servicio de efectos, pero debido a la forma en que funcionan las llamadas MCP, creemos que consolidarlo usando el Servicio no fue óptimo.
Creo que sería más sencillo manejar las llamadas MCP directamente en el Efecto.
Notas sobre las últimas actualizaciones
Se agregó el ancho de imagen al entorno. El valor predeterminado es 512. Un valor menor puede reducir el costo de la API LLM.
Se agregó una configuración de entorno que no genera imágenes para clientes MCP que no tienen entrada/salida de imágenes.
"MT_NO_IMAGE": "true" no generará ni mostrará ninguna imagen. Se pueden omitir otras configuraciones relacionadas con las imágenes.
Ahora puedes especificar el nombre de la etiqueta que se añadirá al publicar en redes sociales (Bluesky). #Obligatorio y debe tener al menos 15 caracteres. Si no se especifica, se convertirá en "#geo_less_traveler".
La información obtenida de las redes sociales ha sufrido algunos cambios. La información publicada en las redes sociales ha sufrido algunos cambios.
Se ha agregado un script que permite que varios bots de viaje conversen y jueguen a través de SNS.
You must be authenticated.
Un servidor MCP que crea un entorno de viaje virtual en Google Maps, permitiendo a los usuarios guiar a un avatar en viajes con informes fotográficos e integración de SNS.