Yandex Maps MCP Server

用于Yandex Maps API的MCP服务器。

"显示柏林的地图"

"显示...的位置"

<p align="center"> <img src="https://raw.githubusercontent.com/peschinskiy/yandex-maps-mcp/main/example-usage.png" width="60%" alt="Yandex Maps MCP截图"> </p>

工具

1. maps_geocode

   • 将地址转换为坐标
   • 输入参数：
     • country（字符串）- 国家名称
     • lang（字符串）- 语言代码（例如：'ru_RU', 'en_US'）
     • state（字符串，可选）- 州、地区或省份名称
     • city（字符串，可选）- 城市或局部区域名称
     • district（字符串，可选）- 城市内的区或社区
     • street（字符串，可选）- 街道名称
     • house_number（字符串，可选）- 房屋或建筑物编号
   • 返回值：位置、格式化地址、地址组件

2. maps_reverse_geocode

   • 将坐标转换为地址
   • 输入参数：
     • latitude（数字）
     • longitude（数字）
     • lang（字符串）- 语言代码（例如：'ru_RU', 'en_US'）
   • 返回值：位置、格式化地址、地址组件

3. maps_render

   • 渲染地图为PNG图像
   • 输入参数：
     • latitude（数字）- 地图中心的纬度坐标
     • longitude（数字）- 地图中心的经度坐标
     • latitude_span（数字）- 地图图像的高度（以度为单位）
     • longitude_span（数字）- 地图图像的宽度（以度为单位）
     • lang（字符串）- 语言代码（例如：'ru_RU', 'en_US'）
     • placemarks（数组，可选）- 显示在地图上的地标数组，样式为"pm2rdm"
       • 每个地标应具有latitude和longitude属性
   • 返回值：地图的PNG图像

配置

API密钥

你需要两个Yandex Maps API密钥：

1. "JavaScript和Geocoder API"密钥用于地理编码功能
2. 静态API密钥用于地图渲染

生成API密钥的方法：

1. 打开 https://developer.tech.yandex.ru/ 并进行授权
2. 点击“连接API”。选择“JavaScript和Geocoder API”并填写表单
3. 导航到API仪表板页面并复制API密钥
4. 从第2步开始重复操作以获取静态API密钥。

本地运行

1. 克隆仓库
2. 安装依赖项：

   npm install
   

3. 设置你的API密钥：

   export YANDEX_MAPS_API_KEY="your-geocoder-api-key"
   export YANDEX_MAPS_STATIC_API_KEY="your-static-api-key"
   

4. 构建服务器

   npm run build
   

5. 运行服务器：

   node dist/index.js
   

使用Claude Desktop

在你的claude_desktop_config.json中添加以下内容：

{
  "mcpServers": {
    "yandex-maps": {
      "command": "node",
      "args": [
        "path/to/index.js"
      ],
      "env": {
        "YANDEX_MAPS_API_KEY": "<YOUR_GEOCODER_API_KEY>",
        "YANDEX_MAPS_STATIC_API_KEY": "<YOUR_STATIC_API_KEY>"
      }
    }
  }
}

已知限制

Yandex Maps Places API没有免费层级，这意味着LLMs无法通过Yandex Maps MCP检索组织的地址和坐标。它只能地理编码那些地址或坐标已经由模型知晓或从其他来源如显式用户输入、网络搜索或第三方MCPs检索到的地方。

许可证

本项目根据MIT许可证发布 - 详情见LICENSE文件。