mcp-mapmyindia

mcp-mapmyindia

Mappls / MapMyIndia API 向け MCP サーバー

Mappls / MapMyIndia API を、Claude などの AI アシスタント向けツールとして公開する MCP（Model Context Protocol） サーバーです。インドの地図データに特化し、ジオコーディング、逆ジオコーディング、場所の検索、周辺スポットの検索、ルート検索、距離計算を行います。

---

ツール

ツール	説明
geocode	住所または場所の名前を座標に変換します
reverse_geocode	座標（緯度／経度）を人が読みやすい住所に変換します
places_search	クエリ文字列で場所を自動補完・検索します
nearby	基準地点の周辺にある場所をキーワードで検索します
directions	2地点間のターンバイターン方式のルート案内を取得します（経由地に対応）
distance_matrix	複数の出発地と目的地間の移動距離と所要時間を計算します
place_detail	eLoc（Mappls の場所 ID）を使用して、場所の詳細情報を取得します

---

セットアップ

API 認証情報を取得する

https://apis.mappls.com に登録し、次のいずれかを取得します：

• API キー（個人利用／テスト向けの簡単な方法）
• OAuth クライアント認証情報（本番環境で推奨）

認証

環境変数に次のいずれかを設定します：

オプション A — OAuth（クライアント認証情報）： 推奨

export MAPPLS_CLIENT_ID=your_client_id
export MAPPLS_CLIENT_SECRET=your_client_secret

オプション B — API キー：

export MAPPLS_API_KEY=your_api_key_here

---

Claude Desktop での使用方法

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "mapmyindia": {
      "command": "npx",
      "args": ["-y", "@bhuvsh/mcp-mapmyindia"],
      "env": {
        "MAPPLS_CLIENT_ID": "your_client_id",
        "MAPPLS_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

または、API キーを使用します：

{
  "mcpServers": {
    "mapmyindia": {
      "command": "npx",
      "args": ["-y", "@bhuvnsh/mcp-mapmyindia"],
      "env": {
        "MAPPLS_API_KEY": "your_api_key_here"
      }
    }
  }
}

設定ファイルの場所：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

---

開発

# Clone and install
git clone https://github.com/bhuvnsh/mcp-mappls.git
cd mcp-mappls
npm install

# Build
npm run build

# Run tests
npm test

# Watch mode (dev)
npm run dev

要件

• Node.js >= 18
• Mappls API キーまたは OAuth クライアント認証情報

---

コントリビューション

コントリビューションを歓迎します。変更したい内容について、まず issue を作成してご相談ください。プルリクエストにはテストを含めてください。

---

ライセンス

MIT