Skip to main content
Glama
deenesjakoruzh
vlad-ds

Street View MCP

by vlad-ds
OverviewInspectSchemaRelated ServersScoreDiscussions
Python
Hybrid

Просмотр улиц MCP

Сервер Model-Client-Protocol (MCP) для API Google Street View, который позволяет моделям ИИ извлекать и отображать изображения улиц и создавать виртуальные туры.

Использование с Claude Desktop

Чтобы использовать Street View MCP с Claude Desktop:

  1. Убедитесь, что у вас установлено uv : Руководство по установке УФ-оборудования

  2. Клонируйте этот репозиторий:

    git clone https://github.com/vlad-ds/street-view-mcp.git cd street-view-mcp

  3. Установить зависимости:

    uv pip install -e ".[dev]"

  4. Получите ключ API Google Карт (инструкции ниже)

  5. Добавьте следующее в файл claude_desktop_config.json вашего рабочего стола Claude:

"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 } }

После настройки вы можете использовать Street View MCP в Claude Desktop, просто введя «/street_view».

Related MCP server: Image Toolkit MCP Server

Обзор

Street View MCP предоставляет простой интерфейс для моделей ИИ для:

  1. Получайте изображения Street View по адресу, координатам или идентификатору панорамы

  2. Сохранение изображений в локальных файлах

  3. Открывайте сохраненные изображения в средстве просмотра по умолчанию

  4. Создавайте HTML-страницы, которые объединяют несколько изображений Street View в виртуальные туры.

Требования

  • Питон 3.9+

  • Ключ API Карт Google с включенным Street View API

  • пакет fastmcp

  • менеджер пакетов uv (рекомендуется)

Установка

# 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]"

Настройка API-ключа

Для Street View MCP требуется ключ API Карт Google с включенным Street View API:

  1. Посетите Google Cloud Console

  2. Создайте новый проект или выберите существующий

  3. Включите «Street View Static API» в библиотеке API

  4. Создайте ключ API на странице «Учетные данные»

  5. Установите ключ API как переменную среды:

# 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

Использование

Запуск MCP-сервера

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

Сервер будет доступен для моделей ИИ на указанном хосте и порту.

Использование в качестве инструмента 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

Инструменты МКП

Street View MCP предоставляет следующие инструменты для моделей ИИ:

get_street_view

Извлекает изображение Street View на основе местоположения, координат или идентификатора панорамы и сохраняет его в файл.

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

Параметры:

  • filename (обязательно): Имя для сохранения изображения (не должно существовать)

  • location (необязательно): Адрес для получения изображения

  • lat_lng (необязательно): координаты, разделенные запятыми (например, «40.748817,-73.985428»)

  • pano_id (необязательно): Конкретный идентификатор панорамы

  • size (необязательно): Размеры изображения как «ширинаxвысота» (по умолчанию: «600x400»)

  • heading (необязательно): направление камеры в градусах (0-360, по умолчанию: 0)

  • pitch (необязательно): наклон камеры в градусах (от -90 до 90, по умолчанию: 0)

  • fov (необязательно): Поле зрения в градусах (10-120, по умолчанию: 90)

  • radius (необязательно): Радиус поиска в метрах (по умолчанию: 50)

  • source (необязательно): Источник изображения («по умолчанию» или «на улице», по умолчанию: «по умолчанию»)

Примечание: необходимо указать только один из параметров location , lat_lng или pano_id .

get_metadata

Извлекает метаданные о панораме Street View.

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

Параметры:

  • Те же параметры местоположения, что и у get_street_view

  • Возвращает метаданные JSON со статусом, авторскими правами, датой, идентификатором панорамы и координатами.

open_image_locally

Открывает сохраненное изображение Street View в приложении по умолчанию.

{ "filename": "empire_state.jpg" }

Параметры:

  • filename (обязательно): имя файла изображения, которое нужно открыть (должно существовать в выходном каталоге)

create_html_page

Создает HTML-страницу, которая отображает несколько изображений Street View в виде виртуального тура.

{ "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>" ] }

Параметры:

  • html_elements (обязательно): Список элементов содержимого HTML

  • filename (обязательно): Имя файла HTML

  • title (необязательно): заголовок страницы (по умолчанию: «Street View Tour»)

Важно: при ссылке на изображения всегда используйте путь ../output/filename.jpg .

Создание виртуальных туров

Street View MCP позволяет создавать виртуальные туры путем объединения нескольких изображений Street View с описательным текстом на HTML-странице.

Пример рабочего процесса создания тура:

  1. Получить изображения разных мест:

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")

  1. Создайте 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>" ] )

Структура проекта

  • street_view_mcp/

    • __init__.py : Инициализация пакета

    • main.py : Точка входа для сервера MCP

    • server.py : реализация сервера MCP

    • street_view.py : Основной клиент Street View API

Важные примечания

  • Локальное хранилище : этот инструмент сохраняет все изображения Street View и HTML-файлы локально в каталоге output/ .

  • Нет автоматической очистки : нет встроенного механизма удаления сохраненных файлов.

  • Ручная очистка : необходимо периодически очищать каталог output/ для управления дисковым пространством.

  • Использование API : каждый запрос изображения учитывается в вашей квоте API Карт Google и может повлечь за собой плату.

Разработка

Тестирование

pytest

Лицензия

Массачусетский технологический институт

One-click Deploy
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

How are these scores calculated?

Resources

Tools

Appeared in Searches

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/vlad-ds/street-view-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server