Yandex Maps MCP Server
2025.04.21
0
JavaScript地图服务地理编码地图渲染位置服务
Yandex Maps MCP Server 是一个为 Yandex Maps API 提供服务的中间件，主要用于地理编码、反向地理编码和地图渲染。它可以将地址转换为坐标，将坐标转换为地址，并生成地图的PNG图像。适用于需要地图服务和位置相关功能的应用程序。
View on GitHub
Overview
基本能力
产品定位
Yandex Maps MCP Server 是一个为 Yandex Maps API 提供服务的中间件，主要用于地理编码、反向地理编码和地图渲染。
核心功能
- 地理编码：将地址转换为坐标。
- 反向地理编码：将坐标转换为地址。
- 地图渲染：生成地图的PNG图像。
适用场景
- 需要地图服务的应用程序。
- 需要将地址转换为坐标或反之的应用程序。
- 需要在地图上显示特定位置或路线的应用程序。
工具列表
maps_geocode：将地址转换为坐标。- 输入：地址（字符串），语言代码（可选）。
- 输出：位置、格式化地址、地址组件。
maps_reverse_geocode：将坐标转换为地址。- 输入：纬度、经度、语言代码（可选）。
- 输出：位置、格式化地址、地址组件。
maps_render：渲染地图为PNG图像。- 输入：纬度、经度、纬度跨度、经度跨度、语言代码（可选）、地标数组（可选）。
- 输出：地图的PNG图像。
常见问题解答
- 如何获取API密钥？
- 访问 https://developer.tech.yandex.ru/ 并授权。
- 选择“JavaScript and Geocoder API”和“Static API”并填写表单。
- 在API的仪表板页面复制API密钥。
- 如何设置环境变量？
- 设置
YANDEX_MAPS_API_KEY和YANDEX_MAPS_STATIC_API_KEY环境变量。
使用教程
使用依赖
- 需要两个 Yandex Maps API 密钥：
- JavaScript and Geocoder API key 用于地理编码功能。
- Static API key 用于地图渲染。
安装教程
- 克隆仓库。
- 安装依赖：
bash npm install - 设置API密钥：
bash export YANDEX_MAPS_API_KEY="your-geocoder-api-key" export YANDEX_MAPS_STATIC_API_KEY="your-static-api-key" - 构建服务器：
bash npm run build - 运行服务器：
bash node dist/index.js # 或者直接使用TypeScript： ts-node dist/index.js index.ts
调试方式
- 确保API密钥已正确设置。
- 运行服务器并检查日志输出。
- 使用工具进行测试，确保地理编码、反向地理编码和地图渲染功能正常工作。