MCP-NAVER-Map

MCP-NAVER-Map

MCP-NAVER-Location は、Naver Cloud の Geolocation API および Directions15 API と連携し、IP アドレスによる位置の検索やルート検索を提供する MCP サーバーです。

---

✨ 機能

📍 IP アドレスによる位置の検索

IP アドレスを指定して、おおよその位置を取得します。

「現在地はどこですか（IP: xxx.xxx.xxx.xxx）？」
→ 📍 指定された IP アドレスに基づいて緯度と経度を返します

• NCP Geolocation API を利用
• IP アドレスの手動入力が必要です

🛣️ ルート検索

指定した 2 地点間の最適な車のルートを取得します。

「市庁からソウル駅まで、どう行けばいいですか？」
→ 🛣️ ルート案内を返します

• NCP Directions15 API を利用

---

🚀 クイックスタート

前提条件

• Python 3.12+
• uv パッケージマネージャー
• Naver Cloud Platform のアカウントと有効化済みの API サービス：
  • Geolocation API
  • Directions15 API
• MCP 対応クライアント（例：Claude for Desktop）

---

1. クローンとセットアップ

# Clone the repository
git clone https://github.com/yourusername/mcp-naver-location.git
cd mcp-naver-map

# Install dependencies
uv sync

認証情報を記述した .env ファイルを作成します：

NAVER_ACCESS_KEY_ID=your_access_key
NAVER_SECRET_KEY=your_secret_key
MAP_CLIENT_ID=your_map_client_id
MAP_CLIENT_SECRET=your_map_client_secret

2. MCP クライアントを設定する

このサーバーを MCP クライアント（例：Claude for Desktop）に登録します。

~/Library/Application Support/Claude/claude_desktop_config.json を編集します：

{
  "mcpServers": {
    "mcp-naver-location": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-naver-location",
        "run",
        "server"
      ]
    }
  }
}

3. Claude を起動する

⚠️ 重要：MCP サーバーとの適切な接続を確立するには、ターミナルから Claude を起動する必要があります。

# macOS:
/Applications/Claude.app/Contents/MacOS/Claude


# Windows:
"C:\Program Files\Claude\Claude.exe"

---

📝 ライセンス

• このプロジェクトは MIT ライセンス の下でライセンスされています。詳細は LICENSE ファイルをご覧ください。
• Model Context Protocol を使用して構築されています