街景 MCP
用于 Google 街景 API 的模型客户端协议 (MCP) 服务器，使 AI 模型能够获取和显示街景图像并创建虚拟游览。
与 Claude Desktop 一起使用
要将街景视图 MCP 与 Claude Desktop 结合使用：
确保已安装
uv： UV 安装指南克隆此存储库：
git clone https://github.com/vlad-ds/street-view-mcp.git cd street-view-mcp安装依赖项：
uv pip install -e ".[dev]"获取 Google 地图 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”即可使用街景 MCP。
Related MCP server: Image Toolkit MCP Server
概述
街景 MCP 为 AI 模型提供了一个简单的界面，可以：
通过地址、坐标或全景图 ID 获取街景图像
将图像保存到本地文件
在默认查看器中打开已保存的图像
创建 HTML 页面，将多张街景图像编译成虚拟游览
要求
Python 3.9+
已启用街景视图 API 的 Google 地图 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 地图 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.jpgMCP 工具
街景 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中的一个。
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 使用情况：每个图像请求都会计入您的 Google Maps API 配额，并且可能会产生费用
发展
测试
pytest执照
麻省理工学院
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.