Skip to main content
Glama
deenesjakoruzh

Street View MCP

by vlad-ds
GitHub
Python
2
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

스트리트 뷰 MCP

AI 모델이 스트리트 뷰 이미지를 가져와 표시하고 가상 투어를 생성할 수 있도록 하는 Google Street View API용 MCP(모델-클라이언트-프로토콜) 서버입니다.

Claude Desktop과 함께 사용

Claude Desktop에서 Street View MCP를 사용하려면:

  1. uv 설치되어 있는지 확인하세요: UV 설치 가이드
  2. 이 저장소를 복제하세요:지엑스피1
  3. 종속성 설치:
    uv pip install -e ".[dev]"
  4. Google Maps API 키 받기(아래 지침 참조)
  5. Claude Desktop claude_desktop_config.json 파일에 다음을 추가하세요.
"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 } }

구성 후, Claude Desktop에서 "/street_view"를 입력하기만 하면 Street View MCP를 사용할 수 있습니다.

개요

Street View MCP는 AI 모델에 다음과 같은 간단한 인터페이스를 제공합니다.

  1. 주소, 좌표 또는 파노라마 ID로 스트리트 뷰 이미지 가져오기
  2. 로컬 파일에 이미지 저장
  3. 기본 뷰어에서 저장된 이미지 열기
  4. 여러 개의 Street View 이미지를 가상 투어로 컴파일하는 HTML 페이지를 만듭니다.

요구 사항

  • 파이썬 3.9 이상
  • Street View API가 활성화된 Google Maps 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에는 Street View API가 활성화된 Google Maps API 키가 필요합니다.

  1. Google Cloud Console을 방문하세요
  2. 새 프로젝트를 만들거나 기존 프로젝트를 선택하세요
  3. API 라이브러리에서 "Street View Static 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

AI 모델은 지정된 호스트와 포트에서 서버를 사용할 수 있습니다.

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

MCP 도구

Street View MCP는 AI 모델에 대해 다음과 같은 도구를 제공합니다.

get_street_view

위치, 좌표 또는 파노라마 ID를 기반으로 스트리트 뷰 이미지를 가져와 파일에 저장합니다.

{ "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 (선택 사항): 특정 파노라마 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

스트리트 뷰 파노라마에 대한 메타데이터를 가져옵니다.

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

매개변수:

  • get_street_view 와 동일한 위치 매개변수
  • 상태, 저작권, 날짜, 파노라마 ID 및 좌표가 포함된 JSON 메타데이터를 반환합니다.

open_image_locally

기본 애플리케이션에서 저장된 Street View 이미지를 엽니다.

{ "filename": "empire_state.jpg" }

매개변수:

  • filename (필수): 열려는 이미지의 파일 이름(출력 디렉토리에 있어야 함)

create_html_page

여러 개의 스트리트 뷰 이미지를 가상 투어로 표시하는 HTML 페이지를 만듭니다.

{ "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 (선택 사항): 페이지 제목(기본값: "스트리트 뷰 투어")

중요: 이미지를 참조할 때는 항상 ../output/filename.jpg 경로를 사용하세요.

가상 투어 만들기

Street View MCP를 사용하면 HTML 페이지에서 여러 개의 Street View 이미지와 설명 텍스트를 결합하여 가상 투어를 만들 수 있습니다.

투어 생성을 위한 워크플로 예시:

  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 : 핵심 스트리트 뷰 API 클라이언트

중요 참고 사항

  • 로컬 저장소 : 이 도구는 모든 Street View 이미지와 HTML 파일을 output/ 디렉토리에 로컬로 저장합니다.
  • 자동 정리 없음 : 저장된 파일을 삭제하는 내장 메커니즘이 없습니다.
  • 수동 정리 : 디스크 공간을 관리하려면 주기적으로 output/ 디렉토리를 정리해야 합니다.
  • API 사용 : 각 이미지 요청은 Google Maps API 할당량에 포함되며 요금이 부과될 수 있습니다.

개발

테스트

pytest

특허

MIT

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

AI 모델이 Google 스트리트 뷰 이미지를 가져와 표시할 수 있는 서버로, 사용자는 어디서나 거리와 랜드마크를 보면서 가상 투어를 만들 수 있습니다.

  1. Claude Desktop과 함께 사용
    1. 개요
      1. 요구 사항
        1. 설치
          1. API 키 설정
            1. 용법
              1. MCP 서버 시작
              2. CLI 도구로 사용
            2. MCP 도구
              1. get_street_view
              2. get_metadata
              3. open_image_locally
              4. create_html_page
            3. 가상 투어 만들기
              1. 프로젝트 구조
                1. 중요 참고 사항
                  1. 개발
                    1. 테스트
                  2. 특허

                    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
                      • Linux
                      • Apple

                    • 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
                      • Linux
                      • Apple

                    • 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

                    New MCP Servers

                    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