mcp-naver-maps

🚀 MCP Naver Maps

MCP（多通道处理器）可连接 Naver Maps API 和 Naver Search API，是一个与 Naver 地图 API 和搜索 API（本地）进行连接的服务器。

目前，它支持以下 API：

• 地理编码
• 本地搜索

🚀 快速开始

✨ 主要特性

• 连接 Naver 地图 API 和搜索 API，实现地理编码和本地搜索功能。

📦 安装指南

前提条件

在开始之前，请确保你已安装以下内容：

• Python：版本 3.13 或更高。
• uv：你可以在 这里 找到安装说明。
• Naver Cloud Platform 账户：你需要 Naver 地图服务的 API 凭证（客户端 ID 和客户端密钥）。你可以从 Naver Cloud Platform 控制台 获取这些信息。
• Naver Developers 账户：你需要 Naver Developers API 的 API 凭证（客户端 ID 和客户端密钥）。你可以从 Naver Developers 获取这些信息。

配置

1. 创建 .env 文件：在项目根目录下创建一个文件。
2. 添加 API 凭证：编辑 .env 文件，并添加你的 Naver 地图 API 凭证和 Naver Developers API 凭证。

   NAVER_MAPS_CLIENT_ID="YOUR_NAVER_MAPS_CLIENT_ID"
   NAVER_MAPS_CLIENT_SECRET="YOUR_NAVER_MAPS_CLIENT_SECRET"
   NAVER_CLIENT_API="YOUR_NAVER_CLIENT_API"
   NAVER_CLIENT_SECRET="YOUR_NAVER_CLIENT_SECRET"
   

   请通过查看 src/mcp_naver_maps/naver_maps_client.py 来验证所需的确切环境变量名称。

运行 MCP

1. 同步依赖项：在终端中导航到项目根目录，并运行以下命令。这将创建一个虚拟环境（如果不存在）并安装 pyproject.toml 中指定的所有依赖项。

   uv sync
   

2. 运行：你可以使用 uv 运行 MCP 服务器。

   uv run src/mcp_naver_maps
   

   对于开发环境，请使用以下命令：

   source .venv/bin/activate
   mcp dev src/mcp_naver_maps/server.py