Просмотр улиц 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")

2. Создайте 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

Лицензия

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