🚀 Yandex Maps MCP 服务器

Yandex Maps MCP 服务器基于 Yandex Maps API 的 MCP（Map Conversion Protocol），可实现地址与坐标转换、地图渲染等功能，助力开发者高效处理地图相关业务。

🚀 快速开始

准备 API 密钥

你需要两个 Yandex Maps API 密钥：

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

生成 API 密钥的方法：

1. 打开 Yandex 开发者平台 并授权登录
2. 点击 "连接 APIs"，选择 "JavaScript and Geocoder API" 并填写表单
3. 访问该 API 的仪表板页面并复制 API 密钥
4. 重复步骤 2 和 3 为静态 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 start

✨ 主要特性

地理编码与逆地理编码

• maps_geocode：将地址转换为坐标，支持输入国家、语言、州、城市等详细地址信息，返回位置、格式化地址和地址组件。
• maps_reverse_geocode：将坐标转换为地址，输入经纬度和语言代码，即可获取对应地址信息。

地图渲染

maps_render：可将地图渲染为 png 图像，支持设置地图中心坐标、图像高度和宽度、语言代码，还能添加地标。

📦 安装指南

克隆仓库

首先，将项目仓库克隆到本地。

安装依赖

在项目根目录下，执行以下命令安装所需依赖：

npm install

配置 API 密钥

设置环境变量，填入你的 API 密钥：

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

启动服务器

安装和配置完成后，运行以下命令启动服务器：

npm start

💻 使用示例

基础用法

地址转坐标

# 使用 maps_geocode 工具将地址转换为坐标
# 示例输入
{
  "country": "Russia",
  "lang": "en_US",
  "city": "Moscow"
}

坐标转地址

# 使用 maps_reverse_geocode 工具将坐标转换为地址
# 示例输入
{
  "latitude": 55.7558,
  "longitude": 37.6173,
  "lang": "en_US"
}

地图渲染

# 使用 maps_render 工具渲染地图为 png 图像
# 示例输入
{
  "latitude": 55.7558,
  "longitude": 37.6173,
  "latitude_span": 0.1,
  "longitude_span": 0.1,
  "lang": "en_US",
  "placemarks": [
    {
      "latitude": 55.7558,
      "longitude": 37.6173
    }
  ]
}

🔧 技术细节

工具详情

已知限制

• 仅支持输入已知的地址或位置数据
• 无法检索未知或未定义的位置信息
• 地图渲染功能可能会受到 API 使用条款的限制

📄 许可证

项目使用 MIT 许可证。