Mappls Mcp

mappls-mcp

Mappls 向けの MCP（Model Context Protocol）サーバーです。Mappls はインド独自の地図プラットフォーム（MapMyIndia）です。インドの住所や場所について、AI エージェントに正確なジオコーディング、ルート検索、近隣検索などを提供します。

Google Maps MCP は存在しますが、インドの位置情報を優先したデータに対応するものがなかったため、開発しました。

ツール（18）

検索とジオコーディング

ツール	説明
geocode	住所または場所の名前 → 緯度／経度
reverse_geocode	緯度／経度 → 人が読めるインドの住所
autosuggest	ユーザーの入力に応じたオートコンプリート候補
text_search	キーワードまたはブランドで検索（例：「Starbucks Delhi」）
nearby_search	ある地点の近くにある病院、ATM、ガソリンスタンド、レストランを検索
place_details	eLoc コードを使って場所の詳細情報を取得
address_analytics	生の住所を構造化された要素に標準化
validate_pincode	6 桁の郵便番号を検証し、地区と州を取得

ルート検索とナビゲーション

ツール	説明
get_directions	ターンバイターン方式のルート案内（自動車／自転車／徒歩）
get_directions_with_traffic	リアルタイムの交通状況を考慮した到着予定時刻
distance_matrix	複数地点間の距離と所要時間
distance_matrix_with_traffic	交通状況を考慮した距離マトリックス
poi_along_route	ルート沿いのガソリンスタンド、レストラン、ATMを検索
snap_to_road	生の GPS 座標を最寄りの道路にスナップ

ユーティリティ

ツール	説明
elevation	任意の緯度／経度地点の海抜高度
aerial_distance	2 地点間の直線距離（カラスが飛ぶ距離）
still_map_image	任意の場所の静的な地図画像 URL を生成

はじめに

1. Mappls API キーを取得する（無料）

1. about.mappls.com/api でサインアップします。無料アカウントで、クレジットカードは不要です。
2. ログイン後、Create New Project をクリックし、プラットフォームとして Cloud を選択します。
3. プロジェクトを開き、Credentials タブに移動して、Static Key をコピーします。
4. Whitelisting タブに移動し、制限なしでアクセスできるように、IP 欄は空欄のままにします。

無料枠には、開発や小規模なプロジェクトに適した十分な API 利用枠が含まれています。

2. インストール

npm install -g mappls-mcp

または、インストールせずに直接実行します。

npx mappls-mcp

または、クローンしてローカルでビルドします。

git clone https://github.com/AmanMakesStuff/mappls-mcp
cd mappls-mcp
npm install && npm run build

3. 設定

API キーを環境変数として設定します。

export MAPPLS_API_KEY=your_static_key_here

---

統合

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します。

{
  "mcpServers": {
    "mappls": {
      "command": "npx",
      "args": ["mappls-mcp"],
      "env": {
        "MAPPLS_API_KEY": "your_static_key_here"
      }
    }
  }
}

Cursor / Windsurf

MCP の設定に追加します。

{
  "mappls": {
    "command": "npx",
    "args": ["mappls-mcp"],
    "env": {
      "MAPPLS_API_KEY": "your_static_key_here"
    }
  }
}

ローカルビルド（代替方法）

リポジトリをクローンした場合は、次のようにします。

{
  "mcpServers": {
    "mappls": {
      "command": "node",
      "args": ["/absolute/path/to/mappls-mcp/build/index.js"],
      "env": {
        "MAPPLS_API_KEY": "your_static_key_here"
      }
    }
  }
}

---

プロンプトの例

接続したら、AI エージェントに次のように尋ねます。

• 「ニューデリーのコンノートプレイスから最寄りの病院を探して」
• 「28.6139, 77.2090 の住所は？」
• 「バンドラからアンデリまでの自動車ルートを教えて」
• 「郵便番号 400001 は有効？どの地域？」
• 「デリーからムンバイまで直線距離でどれくらい？」
• 「シムラーの標高は？」
• 「インド門からクトゥブ・ミナールまでのルート沿いにある ATM を探して」
• 「この住所を標準化して：237 Okhla Industrial Phase 3 ND 110020」
• 「バンガロールのコラマンガラ近くにある Domino's を検索して」

---

注意事項

• すべてのツールは、緯度／経度を度単位の小数で受け付けます（例：28.6139, 77.2090）。
• ルート検索ツールの入力には lat,lng 形式を使います（サーバーが内部で座標を変換します）。
• nearby_search では "hospital"、"atm"、"restaurant" などの一般的なキーワードを使います。Mappls がこれらを自動的にカテゴリコードに変換します。
• poi_along_route には、get_directions のレスポンスにある geometry フィールドから取得したエンコード済みポリラインが必要です。
• still_map_image は URL を返します。画像は PNG 形式の地図タイルです。

ライセンス

MIT — AmanMakesStuff による開発