Vista de calle MCP

Un servidor de protocolo modelo-cliente (MCP) para la API de Google Street View que permite que los modelos de IA obtengan y muestren imágenes de vistas de calles y creen recorridos virtuales.

Uso con Claude Desktop

Para utilizar Street View MCP con Claude Desktop:

Asegúrese de tener instalado uv : Guía de instalación de UV
Clonar este repositorio:
git clone https://github.com/vlad-ds/street-view-mcp.git cd street-view-mcp
Instalar dependencias:
uv pip install -e ".[dev]"
Obtenga una clave API de Google Maps (instrucciones a continuación)
Agregue lo siguiente a su archivo claude_desktop_config.json de Claude Desktop:

"street_view": {
  "command": "uv",
  "args": [
    "run",
    "--directory",
    "/path/to/street-view-mcp",  // Replace with your actual path
    "mcp",
    "run",
    "src/street_view_mcp/server.py"
  ],
  "env": {
    "API_KEY": "your_google_maps_api_key_here"  // Add your API key here
  }
}

Después de la configuración, puedes usar Street View MCP en Claude Desktop simplemente escribiendo "/street_view".

Descripción general

Street View MCP proporciona una interfaz sencilla para que los modelos de IA puedan:

Obtener imágenes de Street View por dirección, coordenadas o ID de panorama
Guardar imágenes en archivos locales
Abrir imágenes guardadas en el visor predeterminado
Cree páginas HTML que compilen múltiples imágenes de Street View en recorridos virtuales

Requisitos

Python 3.9+
Clave API de Google Maps con API de Street View habilitada
paquete fastmcp
gestor de paquetes uv (recomendado)

Instalación

# Clone the repository
git clone https://github.com/vlad-ds/street-view-mcp.git
cd street-view-mcp

# Create and activate a virtual environment with uv (recommended)
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
uv pip install -e ".[dev]"

Configuración de la clave API

El MCP de Street View requiere una clave API de Google Maps con la API de Street View habilitada:

Visita la consola de Google Cloud
Crea un nuevo proyecto o selecciona uno existente
Habilite la "API estática de Street View" en la biblioteca de API
Cree una clave API desde la página Credenciales
Establezca la clave API como una variable de entorno:

# Set temporarily in your shell:
export API_KEY=your_api_key_here

# Or create a .env file in the project root:
echo "API_KEY=your_api_key_here" > .env

Uso

Iniciando el servidor MCP

python -m street_view_mcp.main --host 127.0.0.1 --port 8000

El servidor estará disponible para los modelos de IA en el host y puerto especificados.

Uso como herramienta CLI

# Fetch Street View image by address
python -m street_view_mcp.street_view --address "Empire State Building, NY" --output output/empire_state.jpg

# Fetch Street View image by latitude/longitude
python -m street_view_mcp.street_view --latlong "40.748817,-73.985428" --output output/coords.jpg --heading 180

# Fetch Street View image by panorama ID
python -m street_view_mcp.street_view --pano PANO_ID --output output/panorama.jpg

Herramientas MCP

El MCP de Street View proporciona las siguientes herramientas para modelos de IA:

`get_street_view`

Obtiene una imagen de Street View según la ubicación, las coordenadas o el ID del panorama y la guarda en un archivo.

{
  "filename": "empire_state.jpg",
  "location": "Empire State Building, NY",
  "size": "600x400",
  "heading": 90,
  "pitch": 10
}

Parámetros:

filename (obligatorio): nombre para guardar la imagen (no debe existir ya)
location (opcional): Dirección para obtener la imagen
lat_lng (opcional): coordenadas separadas por comas (p. ej., "40.748817,-73.985428")
pano_id (opcional): ID de panorama específico
size (opcional): Dimensiones de la imagen como "ancho x alto" (predeterminado: "600x400")
heading (opcional): rumbo de la cámara en grados (0-360, predeterminado: 0)
pitch (opcional): Inclinación de la cámara en grados (-90 a 90, predeterminado: 0)
fov (opcional): Campo de visión en grados (10-120, predeterminado: 90)
radius (opcional): radio de búsqueda en metros (predeterminado: 50)
source (opcional): Fuente de la imagen ("predeterminada" o "exterior", predeterminada: "predeterminada")

Nota: Se debe proporcionar exactamente uno de los valores: location , lat_lng o pano_id .

`get_metadata`

Obtiene metadatos sobre un panorama de Street View.

{
  "location": "Empire State Building, NY"
}

Parámetros:

Los mismos parámetros de ubicación que get_street_view
Devuelve metadatos JSON con estado, derechos de autor, fecha, ID de panorama y coordenadas

`open_image_locally`

Abre una imagen de Street View guardada en la aplicación predeterminada.

{
  "filename": "empire_state.jpg"
}

Parámetros:

filename (obligatorio): el nombre del archivo de la imagen a abrir (debe existir en el directorio de salida)

`create_html_page`

Crea una página HTML que muestra múltiples imágenes de Street View como un recorrido virtual.

{
  "filename": "nyc_tour.html",
  "title": "New York City Tour",
  "html_elements": [
    "<h1>New York City Landmarks Tour</h1>",
    "<p>Explore famous landmarks through Street View images.</p>",
    "<h2>Empire State Building</h2>",
    "<img src='../output/empire.jpg' alt='Empire State Building'>",
    "<p class='location'>350 Fifth Avenue, New York, NY</p>",
    "<p class='description'>This 102-story Art Deco skyscraper was completed in 1931.</p>"
  ]
}

Parámetros:

html_elements (obligatorio): Lista de elementos de contenido HTML
filename (obligatorio): nombre del archivo HTML
title (opcional): Título de la página (predeterminado: "Recorrido por Street View")

Importante: Al referenciar imágenes, utilice siempre la ruta ../output/filename.jpg .

Creación de recorridos virtuales

El MCP de Street View permite la creación de recorridos virtuales combinando múltiples imágenes de Street View con texto descriptivo en una página HTML.

Ejemplo de flujo de trabajo para crear un recorrido:

Obtener imágenes de diferentes ubicaciones:

get_street_view(filename="empire.jpg", location="Empire State Building, NY")
get_street_view(filename="times_square.jpg", location="Times Square, NY")
get_street_view(filename="central_park.jpg", location="Central Park, NY")

Crear una página de recorrido HTML:

create_html_page(
  filename="nyc_tour.html",
  title="New York City Tour",
  html_elements=[
    "<h1>New York City Landmarks Tour</h1>",
    "<p>Explore these famous NYC landmarks through Street View images.</p>",
    
    "<h2>Empire State Building</h2>",
    "<img src='../output/empire.jpg' alt='Empire State Building'>",
    "<p class='location'>350 Fifth Avenue, New York, NY</p>",
    "<p class='description'>An iconic 102-story Art Deco skyscraper in Midtown Manhattan.</p>",
    
    "<h2>Times Square</h2>",
    "<img src='../output/times_square.jpg' alt='Times Square'>",
    "<p class='location'>Broadway & 7th Avenue, New York, NY</p>",
    "<p class='description'>Famous for its bright lights, Broadway theaters, and as the site of the annual New Year's Eve ball drop.</p>",
    
    "<h2>Central Park</h2>",
    "<img src='../output/central_park.jpg' alt='Central Park'>",
    "<p class='location'>Central Park, New York, NY</p>",
    "<p class='description'>An urban park spanning 843 acres in the heart of Manhattan.</p>"
  ]
)

Estructura del proyecto

street_view_mcp/
- __init__.py : Inicialización del paquete
- main.py : Punto de entrada para el servidor MCP
- server.py : implementación del servidor MCP
- street_view.py : Cliente de la API principal de Street View

Notas importantes

Almacenamiento local : esta herramienta guarda todas las imágenes de Street View y los archivos HTML localmente en el directorio output/
Sin limpieza automática : no hay un mecanismo integrado para eliminar archivos guardados
Limpieza manual : debe limpiar periódicamente el directorio output/ para administrar el espacio en disco
Uso de API : cada solicitud de imagen cuenta para su cuota de API de Google Maps y puede generar cargos.

Desarrollo

Pruebas

pytest

Licencia

Instituto Tecnológico de Massachusetts (MIT)

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

Un servidor que permite que los modelos de IA obtengan y muestren imágenes de Google Street View, lo que permite a los usuarios crear recorridos virtuales viendo calles y lugares de interés desde cualquier lugar.

Related MCP Servers

Image Toolkit MCP Server
Kira-Pgr
-
security
A
license
-
quality
A server that provides AI-powered image generation, modification, and processing capabilities through the Model Context Protocol, leveraging Google Gemini models and other image services.
Last updated -
6
Python
MIT License
Playwright MCP Server
Kotelberg
-
security
F
license
-
quality
A server that enables AI systems to browse, retrieve content from, and interact with web pages through the Model Context Protocol.
Last updated -
Map Traveler MCP
mfukushim
A
security
A
license
A
quality
An MCP server that creates a virtual traveling environment on Google Maps, allowing users to guide an avatar on journeys with photo reports and SNS integration.
Last updated -
2
20
12
TypeScript
MIT License
Kakao API MCP Server
jeong-sik
-
security
A
license
-
quality
A server that enables AI models to access Kakao Map features (place search, address lookup, route finding) and Daum search services (web, image, blog, cafe) through Model Context Protocol.
Last updated -
3
TypeScript
MIT License

View all related MCP servers

Street View MCP