Yandex Maps MCP

🚀 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 許可證。