Yandex Maps MCP

🚀 Yandex Maps MCP サーバ

Yandex Maps API の MCP（Map Conversion Protocol）サーバです。このサーバを使用することで、地理コーディングや地図レンダリングなどの機能を利用できます。

"ベルリンの地図を表示"

"～の位置を表示"

✨ 主な機能

このサーバは以下の主要な機能を提供します。

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 キー

このサーバを使用するには、2 つの Yandex Maps API キーが必要です。

1. 地理コーディング機能には "JavaScript and Geocoder API" キーが必要です。
2. 地図レンダリングには静的 API キーが必要です。

API キーを生成する手順は以下の通りです。

1. https://developer.tech.yandex.ru/ を開き、ログインします。
2. "接続 APIs" をクリックします。"JavaScript and Geocoder API" を選択し、フォームを入力します。
3. この API のダッシュボードページにアクセスし、API キーをコピーします。
4. 静的 API のキーを生成するために、手順 2 と 3 を繰り返します。

ローカルでの実行

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
   

🔧 技術詳細

既知の制限事項

• 既知の住所または位置データの入力のみをサポートしています。
• 未知または未定義の位置情報を取得することはできません。
• 地図レンダリング機能は、API の利用規約による制限を受ける場合があります。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。