https://github.com/yunkee-lee/mcp-naver-maps
The MCP connects to the Naver Maps API and Naver Search API. 네이버 지도 API와 검색 API에 (로컬) 연결하는 MCP 서버.
https://github.com/yunkee-lee/mcp-naver-maps
Last synced: 3 months ago
JSON representation
The MCP connects to the Naver Maps API and Naver Search API. 네이버 지도 API와 검색 API에 (로컬) 연결하는 MCP 서버.
- Host: GitHub
- URL: https://github.com/yunkee-lee/mcp-naver-maps
- Owner: yunkee-lee
- License: mit
- Created: 2025-05-03T23:18:11.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-05-12T03:40:37.000Z (5 months ago)
- Last Synced: 2025-05-12T04:33:01.035Z (5 months ago)
- Language: Python
- Homepage:
- Size: 12.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# MCP Naver Maps
The MCP connects to the [Naver Maps API](https://www.ncloud.com/product/applicationService/maps) and [Naver Search API](https://developers.naver.com/products/service-api/search/search.md). 네이버 지도 API와 검색 API에 (로컬) 연결하는 MCP 서버.
It currently supports the following APIs:
* [Geocoding](https://api.ncloud-docs.com/docs/application-maps-geocoding)
* [Local saerch](https://developers.naver.com/docs/serviceapi/search/local/local.md#%EC%A7%80%EC%97%AD)
## Prerequisites
Before you begin, ensure you have the following installed:
* **Python:** Version 3.13 or higher
* **uv:** You can find installation instructions [here](https://github.com/astral-sh/uv).
* **Naver Cloud Platform Account:** You need API credentials (Client ID and Client Secret) for the Naver Maps service. You can obtain these from the [Naver Cloud Platform console](https://www.ncloud.com/).
* **Naver Develoeprs Account:** You need API credentials (Client ID and Client Secret) for the Naver Developers API. You can obtain these from the [Naver Developers](https://developers.naver.com/main/).
## Configuration
1. **Create a `.env` file:** Create a file in the project root.
2. **Add API Credentials:** Edit the `.env` file and add your Naver Maps API credentials and Naver Developers API credentials.
```.env
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"
```
Please verify the exact environment variable names required by checking `src/mcp_naver_maps/naver_maps_client.py`.
## Running the MCP
1. **Sync Dependencies:** Navigate to the project root directory in your terminal and run the following command. This will create a virtual environment (if one doesn't exist) and install all dependencies specified in `pyproject.toml`.
```bash
uv sync
```
2. **Run:**: You can run the MCP server using `uv`.
```bash
uv run src/mcp_naver_maps
```
For development,
```bash
source .venv/bin/activate
mcp dev src/mcp_naver_maps/server.py
```