使用说明

街景MCP

用于谷歌街景API的模型客户端协议（MCP）服务器，使人工智能模型能够获取和显示街景图像并创建虚拟旅游。

与Claude Desktop一起使用

要在Claude Desktop中使用街景MCP：

确保你有 uv 安装：紫外线安装指南

克隆此存储库：

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

安装依赖项：
```
uv pip install -e ".[dev]"
```
获取Google Maps API密钥（说明如下）
将以下内容添加到您的Claude桌面 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
  }
}

配置后，您只需键入“/Street_View”即可在Claude Desktop中使用街景MCP。

概述

街景MCP为AI模型提供了一个简单的界面，用于：

按地址、坐标或全景ID获取街景图像
将图像保存到本地文件
在默认查看器中打开保存的图像
创建HTML页面，将多个街景图像编译成虚拟旅游

需求

Python 3.9+
启用了街景API的谷歌地图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密钥设置

街景MCP需要启用街景API的Google Maps API密钥：

访问谷歌云控制台
创建新项目或选择现有项目
启用API库中的“街景静态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工具

街景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 （可选）：图像尺寸为“widthxheight”（默认值：“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`

在默认应用程序中打开已保存的街景图像。

{
  "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.

创建虚拟旅游

街景MCP通过在HTML页面中组合多个街景图像和描述性文本来创建虚拟旅游。

创建旅游的示例工作流程：

获取不同位置的图像：

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客户端

重要提示

本地存储：此工具将所有街景图像和HTML文件保存在本地 output/ 目录
无自动清理：没有删除已保存文件的内置机制
手动清理：你应该定期清理 output/ 用于管理磁盘空间的目录
API使用：每个图像请求都计入您的谷歌地图API配额，并可能产生费用

发展

测试

pytest

许可证

麻省理工学院

使用说明

街景MCP

与Claude Desktop一起使用

概述

需求

安装

API密钥设置

用法

启动MCP服务器

用作CLI工具

MCP工具

get_street_view

get_metadata

open_image_locally

create_html_page

创建虚拟旅游

项目结构

重要提示

发展

测试

许可证

相关 MCP

高德地图位置服务

百度地图

地图服务接口

滴滴出行MCP服务

AIGoHotel(酒店预订）

地图API服务

`get_street_view`

`get_metadata`

`open_image_locally`

`create_html_page`