Yandex Maps MCP Server

Yandex Maps MCP サーバー

Yandex Maps API 用の MCP サーバーです。

「ベルリンの地図を表示して」

「…の場所を表示して」

ツール

1. maps_geocode

   • 住所を座標に変換します
   • 入力：
     • country (string) - 国名
     • lang (string) - 言語コード（例：'ru_RU'、'en_US'）
     • state (string, optional) - 州、地域、または県の名前
     • city (string, optional) - 都市または地域の名前
     • district (string, optional) - 都市内の地区または近隣地域
     • street (string, optional) - 通りの名前
     • house_number (string, optional) - 家屋または建物の番号
   • 戻り値：location、formatted_address、address_components

2. maps_reverse_geocode

   • 座標を住所に変換します
   • 入力：
     • latitude (number)
     • longitude (number)
     • lang (string) - 言語コード（例：'ru_RU'、'en_US'）
   • 戻り値：location、formatted_address、address_components

3. maps_render

   • 地図を PNG 画像として描画します
   • 入力：
     • latitude (number) - 地図の中心の緯度座標
     • longitude (number) - 地図の中心の経度座標
     • latitude_span (number) - 地図画像の高さ（度）
     • longitude_span (number) - 地図画像の幅（度）
     • lang (string) - 言語コード（例：'ru_RU'、'en_US'）
     • placemarks (array, optional) - スタイル「pm2rdm」で地図上に表示するプレースマークの配列
       • 各プレースマークには latitude と longitude プロパティが必要です
   • 戻り値：地図の PNG 画像

セットアップ

API キー

Yandex Maps API キーが 2 つ必要です。

1. ジオコーディング機能用の「JavaScript and Geocoder API」キー
2. 地図描画用の静的 API キー

API キーを生成するには：

1. https://developer.tech.yandex.ru/ を開き、認証します
2. 「Connect APIs」をクリックします。「JavaScript and Geocoder API」を選択し、フォームに入力します
3. API のダッシュボードページに移動し、そこで API キーをコピーします
4. 手順 2 から繰り返し、Static 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 での使用（stdio）

以下を 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>"
      }
    }
  }
}

HTTP サーバーとしての使用

このサーバーは、n8n などのリモートアクセスやウェブベースのクライアント向けに、Streamable HTTP トランスポートをサポートしています。

HTTP サーバーの起動

# Set required environment variables
export YANDEX_MAPS_API_KEY="your-geocoder-api-key"
export YANDEX_MAPS_STATIC_API_KEY="your-static-api-key"
export MCP_TRANSPORT="http"
export MCP_PORT="3000"  # Optional, defaults to 3000
export MCP_AUTH_TOKEN="your-secret-token"  # Optional but recommended

# Run the server
node dist/index.js

設定

HTTP サーバーはステートレスで、以下の環境変数を使用します。

• MCP_TRANSPORT：HTTP モードを有効にするには "http" を設定します（デフォルト：「stdio」）
• MCP_PORT：HTTP サーバーのポート番号（デフォルト：3000）
• MCP_AUTH_TOKEN：認証用のオプションの Bearer トークンです。設定しない場合、サーバーは認証なしで実行されます（本番環境では推奨されません）
• YANDEX_MAPS_API_KEY：Yandex Geocoder API キー（必須）
• YANDEX_MAPS_STATIC_API_KEY：Yandex Static Maps API キー（必須）

認証

MCP_AUTH_TOKEN が設定されている場合、クライアントは Authorization ヘッダーにその値を含める必要があります：

Authorization: Bearer your-secret-token

n8n での使用

n8n で使用するには、MCP Client ノードを次のように設定します：

• サーバーのトランスポート：HTTP Streamable
• URL：http://your-server:3000（必要に応じてホストとポートを変更してください）
• 認証：設定している場合は Bearer トークンを追加します

既知の制限事項

Yandex Maps Places API には無料プランがありません。そのため、LLM は Yandex Maps MCP を通じて組織の住所や座標を取得できません。モデルがすでに把握している住所や座標、またはユーザーからの明示的な入力、Web Search、サードパーティの MCP など、他の情報源から取得した住所や座標を持つ場所のみ、ジオコーディングできます。

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳細は LICENSE ファイルをご覧ください。