스트리트 뷰 MCP
AI 모델이 스트리트 뷰 이미지를 가져와 표시하고 가상 투어를 생성할 수 있도록 하는 Google Street View API용 MCP(모델-클라이언트-프로토콜) 서버입니다.
Claude Desktop과 함께 사용
Claude Desktop에서 Street View MCP를 사용하려면:
uv 설치되어 있는지 확인하세요: UV 설치 가이드- 이 저장소를 복제하세요:지엑스피1
- 종속성 설치:
uv pip install -e ".[dev]"
- Google Maps API 키 받기(아래 지침 참조)
- 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 모델에 다음과 같은 간단한 인터페이스를 제공합니다.
- 주소, 좌표 또는 파노라마 ID로 스트리트 뷰 이미지 가져오기
- 로컬 파일에 이미지 저장
- 기본 뷰어에서 저장된 이미지 열기
- 여러 개의 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 키가 필요합니다.
- Google Cloud Console을 방문하세요
- 새 프로젝트를 만들거나 기존 프로젝트를 선택하세요
- API 라이브러리에서 "Street View Static API"를 활성화하세요.
- 자격 증명 페이지에서 API 키를 만듭니다.
- 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 (선택 사항): 특정 파노라마 IDsize (선택 사항): 이미지 크기는 "너비x높이"입니다(기본값: "600x400")heading (선택 사항): 카메라 방향(도 단위, 0~360, 기본값: 0)pitch (선택 사항): 카메라 피치(-90~90도, 기본값: 0)fov (선택 사항): 시야각(도 단위, 10~120, 기본값: 90)radius (선택 사항): 검색 반경(미터)(기본값: 50)source (선택 사항): 이미지 출처("기본값" 또는 "실외", 기본값: "기본값")
참고: location , lat_lng 또는 pano_id 중 하나만 제공해야 합니다.
스트리트 뷰 파노라마에 대한 메타데이터를 가져옵니다.
{
"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 이미지와 설명 텍스트를 결합하여 가상 투어를 만들 수 있습니다.
투어 생성을 위한 워크플로 예시:
- 다양한 위치의 이미지 가져오기:
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")
- 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 할당량에 포함되며 요금이 부과될 수 있습니다.
개발
테스트
특허
MIT