{"_id":"@devyhan/naver-maps-mcp","_rev":"9-91b1aa16d947ae436a4500d2f93f6d7c","name":"@devyhan/naver-maps-mcp","dist-tags":{"latest":"1.2.2"},"versions":{"1.0.0":{"name":"@devyhan/naver-maps-mcp","version":"1.0.0","keywords":["MCP","Maps","Naver","API"],"author":"","license":"ISC","_id":"@devyhan/naver-maps-mcp@1.0.0","maintainers":[{"name":"devyhan","email":"devyhan93@gmail.com"}],"bin":{"naver-maps-mcp":"bin/cli.js"},"dist":{"shasum":"2c3dc8f92213016cd3b00b8adcb2deeaa042cdc7","tarball":"https://registry.npmjs.org/@devyhan/naver-maps-mcp/-/naver-maps-mcp-1.0.0.tgz","fileCount":15,"integrity":"sha512-2LoGb8SbDKA4o4CebBDznZP56j14qiJEgMinCq8Z4EiCOzmtIFcjtrJF2k4eTWsHeamIfEYihUMePnKLib5b5w==","signatures":[{"sig":"MEQCIDjpiJIvgC9Jwqpp6g4Vi4SNRnCdbEVQ6p+DLVenBUVxAiBsiZlEhu9yrs0CE4jw2Z1abLWvxYeGdktaLVdX16muhw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":42871},"main":"index.js","type":"module","gitHead":"c9f098ab5b8e26ef6c0493203d7ca0adba9f9f00","scripts":{"dev":"nodemon web-server.js","test":"node tests/test.js","start":"node web-server.js"},"_npmUser":{"name":"devyhan","email":"devyhan93@gmail.com"},"_npmVersion":"10.8.2","description":"MCP 서버 for 네이버 지도 API","directories":{},"_nodeVersion":"20.18.1","dependencies":{"cors":"^2.8.5","axios":"^1.6.8","dotenv":"^16.4.5","express":"^5.0.1","@modelcontextprotocol/sdk":"^1.7.0"},"_hasShrinkwrap":false,"devDependencies":{"nodemon":"^3.1.0"},"_npmOperationalInternal":{"tmp":"tmp/naver-maps-mcp_1.0.0_1743038351257_0.14482663944449436","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@devyhan/naver-maps-mcp","version":"1.0.2","keywords":["MCP","Maps","Naver","API"],"author":"","license":"ISC","_id":"@devyhan/naver-maps-mcp@1.0.2","maintainers":[{"name":"devyhan","email":"devyhan93@gmail.com"}],"bin":{"naver-maps-mcp":"bin/cli.js"},"dist":{"shasum":"883e8e0167e52a2c06c258bd9465af415903f064","tarball":"https://registry.npmjs.org/@devyhan/naver-maps-mcp/-/naver-maps-mcp-1.0.2.tgz","fileCount":15,"integrity":"sha512-DWVk7Hgrx5kCrvB2EkX4DAMFwG5IrxTxgb1L8XYoJA47srzTD/tfyjedVJQb7N1Y7a3rU2BwKfUFSkFAcrmE9g==","signatures":[{"sig":"MEYCIQCMUondqtQA1n/uE5umXmQ4HQrXQfbohJ1T4zeGW1sl8QIhAPkk2V5M+8PfZ6in+8WkPYzptgewsK2JUef/gA4qnMsL","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":43006},"main":"index.js","type":"module","gitHead":"d5f27706b387163eace7f7b11f9c56f1944ba090","scripts":{"dev":"nodemon web-server.js","test":"node tests/test.js","start":"node web-server.js"},"_npmUser":{"name":"devyhan","email":"devyhan93@gmail.com"},"_npmVersion":"10.8.2","description":"MCP 서버 for 네이버 지도 API","directories":{},"_nodeVersion":"20.18.1","dependencies":{"cors":"^2.8.5","axios":"^1.6.8","dotenv":"^16.4.5","express":"^5.0.1","@modelcontextprotocol/sdk":"^1.7.0"},"_hasShrinkwrap":false,"devDependencies":{"nodemon":"^3.1.0"},"_npmOperationalInternal":{"tmp":"tmp/naver-maps-mcp_1.0.2_1743039230631_0.827966540045763","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@devyhan/naver-maps-mcp","version":"1.0.3","keywords":["MCP","Maps","Naver","API"],"author":"","license":"ISC","_id":"@devyhan/naver-maps-mcp@1.0.3","maintainers":[{"name":"devyhan","email":"devyhan93@gmail.com"}],"bin":{"naver-maps-mcp":"bin/cli.js"},"dist":{"shasum":"2b573a87f070090cdfb859c23d39c8383341cb5b","tarball":"https://registry.npmjs.org/@devyhan/naver-maps-mcp/-/naver-maps-mcp-1.0.3.tgz","fileCount":15,"integrity":"sha512-dbfmXRUumJNRKEMXypjgyFDBfMJ4uHB0Jm95KCiUZ67/M8ymnoS+5FQjlT47rXDSNe0fY5l12pqfSCRoxSPvDg==","signatures":[{"sig":"MEYCIQCK0iPngTjFGk8gx41VUn5RWvIDI3PnOLJ6B8vMcrC3DgIhAJbpfbmHulAmBMN/mtg5OwzuVrzDbVPUhKnSScS7MHgw","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":50623},"main":"index.js","type":"module","gitHead":"a3cd9dcba15f87e503eda6dbfb89331bb95a1e77","scripts":{"dev":"nodemon web-server.js","test":"node tests/test.js","start":"node web-server.js"},"_npmUser":{"name":"devyhan","email":"devyhan93@gmail.com"},"_npmVersion":"10.8.2","description":"MCP 서버 for 네이버 지도 API","directories":{},"_nodeVersion":"20.18.1","dependencies":{"cors":"^2.8.5","axios":"^1.6.8","dotenv":"^16.4.5","express":"^5.0.1","@modelcontextprotocol/sdk":"^1.7.0"},"_hasShrinkwrap":false,"devDependencies":{"nodemon":"^3.1.0"},"_npmOperationalInternal":{"tmp":"tmp/naver-maps-mcp_1.0.3_1743040885992_0.39737275857894394","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@devyhan/naver-maps-mcp","version":"1.1.0","keywords":["MCP","Maps","Naver","API"],"author":"","license":"ISC","_id":"@devyhan/naver-maps-mcp@1.1.0","maintainers":[{"name":"devyhan","email":"devyhan93@gmail.com"}],"bin":{"naver-maps-mcp":"bin/cli.js"},"dist":{"shasum":"ed65a19778da38fd4b3111b7d5dcff7bdf12d7ea","tarball":"https://registry.npmjs.org/@devyhan/naver-maps-mcp/-/naver-maps-mcp-1.1.0.tgz","fileCount":15,"integrity":"sha512-5KNqSWHizIgHAKkElFgk1uzRDijcXc5EPTHPsisDyCCQtr9UgXSvSYIglDexEA3DBX+snyk3eIB5E0le8uigWQ==","signatures":[{"sig":"MEUCIEtfIVskW96ebxuvGpea3eyUmJy7kUI8/FcebshGqMliAiEAxOgnUzTRJsZFOGiztOirALFd20MUhVUtsfLRyFyMHCM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":54018},"main":"index.js","type":"module","exports":{".":{"import":"./index.js","require":"./index.js"}},"gitHead":"a1d19e6aa4704a21d0afd25e2058c13d2d68c2cd","scripts":{"dev":"nodemon web-server.js","test":"node tests/test.js","start":"node web-server.js"},"_npmUser":{"name":"devyhan","email":"devyhan93@gmail.com"},"_npmVersion":"10.8.2","description":"MCP 서버 for 네이버 지도 API","directories":{},"_nodeVersion":"20.18.1","dependencies":{"cors":"^2.8.5","axios":"^1.6.8","dotenv":"^16.4.5","express":"^5.0.1","@modelcontextprotocol/sdk":"^1.7.0"},"_hasShrinkwrap":false,"devDependencies":{"nodemon":"^3.1.0"},"_npmOperationalInternal":{"tmp":"tmp/naver-maps-mcp_1.1.0_1743041490137_0.6347046436511898","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"@devyhan/naver-maps-mcp","version":"1.1.1","keywords":["MCP","Maps","Naver","API"],"author":"","license":"ISC","_id":"@devyhan/naver-maps-mcp@1.1.1","maintainers":[{"name":"devyhan","email":"devyhan93@gmail.com"}],"bin":{"naver-maps-mcp":"bin/cli.js"},"dist":{"shasum":"62bf1df6b243c5464ce6bed7711f56d59a338500","tarball":"https://registry.npmjs.org/@devyhan/naver-maps-mcp/-/naver-maps-mcp-1.1.1.tgz","fileCount":15,"integrity":"sha512-ld28fuAi4q693K0h29vv/JkMrhciXDDVRiYKTDrzrOlXifzwS+TZmB/F2sSCpJc/UKBLwCBrvQE5blgpqu6YLA==","signatures":[{"sig":"MEYCIQDJaehvc146cAqR/ePOwWF05lNml0K14xOfZjbVuEqRsQIhAOVfhT8vWnBoZbO8N9YNfIis3CHuCiKAURJPIYUKTCWQ","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":53681},"main":"index.js","type":"module","exports":{".":{"import":"./index.js","require":"./index.js"}},"gitHead":"e140a4e473b1437e492f96f6ff9170f780199a73","scripts":{"dev":"nodemon web-server.js","test":"node tests/test.js","start":"node web-server.js"},"_npmUser":{"name":"devyhan","email":"devyhan93@gmail.com"},"_npmVersion":"10.8.2","description":"MCP 서버 for 네이버 지도 API","directories":{},"_nodeVersion":"20.18.1","dependencies":{"cors":"^2.8.5","axios":"^1.6.8","dotenv":"^16.4.5","express":"^5.0.1","@modelcontextprotocol/sdk":"^1.7.0"},"_hasShrinkwrap":false,"devDependencies":{"nodemon":"^3.1.0"},"_npmOperationalInternal":{"tmp":"tmp/naver-maps-mcp_1.1.1_1743042132511_0.8367026152245958","host":"s3://npm-registry-packages-npm-production"}},"1.1.2":{"name":"@devyhan/naver-maps-mcp","version":"1.1.2","keywords":["MCP","Maps","Naver","API"],"author":"","license":"ISC","_id":"@devyhan/naver-maps-mcp@1.1.2","maintainers":[{"name":"devyhan","email":"devyhan93@gmail.com"}],"bin":{"naver-maps-mcp":"bin/cli.js"},"dist":{"shasum":"8009ac859ecfab64a64e58fc99b94b62e29e3741","tarball":"https://registry.npmjs.org/@devyhan/naver-maps-mcp/-/naver-maps-mcp-1.1.2.tgz","fileCount":16,"integrity":"sha512-sE/Rwn5ATK1e3SPthvw75/xX/g42WhmcQred2en4y6/D/Fbv3OgK6qZB6rwiQgXGb79co4hrd9sFdR6RPstIlQ==","signatures":[{"sig":"MEUCIA5GAH5ldCXCo35bYAw8Cd/rbSSCkghs11hT1fCVtPvUAiEAmq8iSUiBp0/GXH9AGwj2U300YkDjMPZlM4Q2c//n+kY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":53863},"main":"index.js","type":"module","exports":{".":{"import":"./index.js","require":"./index.js"}},"gitHead":"5c329ed7ef445909da98ef545b9df4f82a62e52d","scripts":{"dev":"nodemon web-server.js","test":"node tests/test.js","start":"node web-server.js"},"_npmUser":{"name":"devyhan","email":"devyhan93@gmail.com"},"_npmVersion":"10.8.2","description":"MCP 서버 for 네이버 지도 API","directories":{},"_nodeVersion":"20.18.1","dependencies":{"cors":"^2.8.5","axios":"^1.6.8","dotenv":"^16.4.5","express":"^5.0.1","@modelcontextprotocol/sdk":"^1.7.0"},"_hasShrinkwrap":false,"devDependencies":{"nodemon":"^3.1.0"},"_npmOperationalInternal":{"tmp":"tmp/naver-maps-mcp_1.1.2_1743046064894_0.9092591462562114","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@devyhan/naver-maps-mcp","version":"1.2.0","keywords":["MCP","Maps","Naver","API"],"author":"","license":"ISC","_id":"@devyhan/naver-maps-mcp@1.2.0","maintainers":[{"name":"devyhan","email":"devyhan93@gmail.com"}],"bin":{"naver-maps-mcp":"bin/cli.js"},"dist":{"shasum":"e32e09b00450589fe670bb3e93d592f1ff8b4573","tarball":"https://registry.npmjs.org/@devyhan/naver-maps-mcp/-/naver-maps-mcp-1.2.0.tgz","fileCount":16,"integrity":"sha512-U3s256v+NBvm7CY1h0RuAU6ean+LLFF9OnnOdQqXKWj/kRmqtBhp3nhlmZLVDp1xY4zxjqgJKEDlnfXpbTAvJg==","signatures":[{"sig":"MEYCIQCjN/QWHgpfk20DIX8tIpzBL5eyG+2SFVEOWWlKbSLbfgIhAJyzsjmAfLSeUgAj+S2PmyX3B7qvjLJw6iNMHIN7pRgL","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":63916},"main":"index.js","type":"module","exports":{".":{"import":"./index.js","require":"./index.js"}},"gitHead":"682c68bf9b1a59db366b266f87a6fb019167450d","scripts":{"dev":"nodemon web-server.js","test":"node tests/test.js","start":"node web-server.js"},"_npmUser":{"name":"devyhan","email":"devyhan93@gmail.com"},"_npmVersion":"10.8.2","description":"MCP 서버 for 네이버 지도 API","directories":{},"_nodeVersion":"20.18.1","dependencies":{"cors":"^2.8.5","axios":"^1.6.8","dotenv":"^16.4.5","express":"^5.0.1","@modelcontextprotocol/sdk":"^1.7.0"},"_hasShrinkwrap":false,"devDependencies":{"nodemon":"^3.1.0"},"_npmOperationalInternal":{"tmp":"tmp/naver-maps-mcp_1.2.0_1743048229856_0.3715943788335614","host":"s3://npm-registry-packages-npm-production"}},"1.2.1":{"name":"@devyhan/naver-maps-mcp","version":"1.2.1","keywords":["MCP","Maps","Naver","API"],"author":"","license":"ISC","_id":"@devyhan/naver-maps-mcp@1.2.1","maintainers":[{"name":"devyhan","email":"devyhan93@gmail.com"}],"bin":{"naver-maps-mcp":"bin/cli.js"},"dist":{"shasum":"82b1c1603f9de3201c985eb98a39bf74b625bcba","tarball":"https://registry.npmjs.org/@devyhan/naver-maps-mcp/-/naver-maps-mcp-1.2.1.tgz","fileCount":16,"integrity":"sha512-zSE/cXvSujSKhXBWLGzpFYZonbPqdIb/qrJZ6L4CAlD1qeelSNZA4PoOpcyT3MaV7qur3btqE389XfRQ3M0/UA==","signatures":[{"sig":"MEYCIQCu8l2xGWhYvt+IafJYUmt4G2gf6ODJSRDKTBNUDlGYmgIhAMECKFqqN/nVrFD0yfwKbXwvceBAl8UJmefYq33wEnJp","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":75185},"main":"index.js","type":"module","exports":{".":{"import":"./index.js","require":"./index.js"}},"gitHead":"fee3922adf51e62bd514fc44bdc1882710f7543e","scripts":{"dev":"nodemon web-server.js","test":"node tests/test.js","start":"node web-server.js"},"_npmUser":{"name":"devyhan","email":"devyhan93@gmail.com"},"_npmVersion":"10.8.2","description":"MCP 서버 for 네이버 지도 API","directories":{},"_nodeVersion":"20.18.1","dependencies":{"cors":"^2.8.5","axios":"^1.6.8","dotenv":"^16.4.5","express":"^5.0.1","@modelcontextprotocol/sdk":"^1.7.0"},"_hasShrinkwrap":false,"devDependencies":{"nodemon":"^3.1.0"},"_npmOperationalInternal":{"tmp":"tmp/naver-maps-mcp_1.2.1_1743049061502_0.9611460215200525","host":"s3://npm-registry-packages-npm-production"}},"1.2.2":{"name":"@devyhan/naver-maps-mcp","version":"1.2.2","description":"MCP 서버 for 네이버 지도 API","main":"index.js","type":"module","exports":{".":{"import":"./index.js","require":"./index.js"}},"scripts":{"start":"node web-server.js","dev":"nodemon web-server.js","test":"node tests/test.js"},"bin":{"naver-maps-mcp":"bin/cli.js"},"keywords":["MCP","Maps","Naver","API"],"author":"","license":"ISC","dependencies":{"@modelcontextprotocol/sdk":"^1.7.0","axios":"^1.6.8","cors":"^2.8.5","dotenv":"^16.4.5","express":"^5.0.1"},"devDependencies":{"nodemon":"^3.1.0"},"_id":"@devyhan/naver-maps-mcp@1.2.2","gitHead":"22f778a4ed0982e96727f10b86c3cb343987d6df","_nodeVersion":"20.18.1","_npmVersion":"10.8.2","dist":{"integrity":"sha512-q25jjSWyWkciaqvv2w2HneW+KVtX4gymubOt09Ki4WCUnY307eQyjrJozRVqzDjhVb3DW9irQGexlt0TpgnqYQ==","shasum":"bda4dcc22997458d5386add4251e9e7eaac9539c","tarball":"https://registry.npmjs.org/@devyhan/naver-maps-mcp/-/naver-maps-mcp-1.2.2.tgz","fileCount":16,"unpackedSize":81193,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIA/7E7xg3fdHAkxgCgz0pLDvhi1n9QV8pb7KHWTJPGt/AiAdwivQ3EROSRcNqLhMzU9XHB4697spHFJQmb8XcS5urA=="}]},"_npmUser":{"name":"devyhan","email":"devyhan93@gmail.com"},"directories":{},"maintainers":[{"name":"devyhan","email":"devyhan93@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/naver-maps-mcp_1.2.2_1743049857132_0.6870835935152424"},"_hasShrinkwrap":false}},"time":{"created":"2025-03-27T01:19:11.201Z","modified":"2025-03-27T04:30:57.544Z","1.0.0":"2025-03-27T01:19:11.425Z","1.0.2":"2025-03-27T01:33:50.803Z","1.0.3":"2025-03-27T02:01:26.196Z","1.1.0":"2025-03-27T02:11:30.335Z","1.1.1":"2025-03-27T02:22:12.720Z","1.1.2":"2025-03-27T03:27:45.151Z","1.2.0":"2025-03-27T04:03:50.010Z","1.2.1":"2025-03-27T04:17:41.724Z","1.2.2":"2025-03-27T04:30:57.358Z"},"license":"ISC","keywords":["MCP","Maps","Naver","API"],"description":"MCP 서버 for 네이버 지도 API","maintainers":[{"name":"devyhan","email":"devyhan93@gmail.com"}],"readme":"# Naver Maps MCP Server\n\n[![npm version](https://img.shields.io/npm/v/@devyhan/naver-maps-mcp.svg)](https://www.npmjs.com/package/@devyhan/naver-maps-mcp)\n\nA Model Context Protocol (MCP) server that integrates with Naver Maps API, allowing AI applications like Claude to utilize geographical services such as geocoding, reverse geocoding, and route searching without direct API access.\n\n## Core Concepts\n\n### Geographical Data\n\nGeographical data is represented primarily as coordinates (latitude and longitude) or addresses:\n\n- **Coordinates**: Precise geographical points with latitude and longitude values\n  ```json\n  {\n    \"latitude\": 37.5058,\n    \"longitude\": 127.0556\n  }\n  ```\n\n- **Addresses**: Human-readable location references that can be converted to coordinates\n  ```\n  \"서울특별시 강남구 테헤란로 129\"\n  ```\n\n### Routes\n\nRoutes define paths between geographical points:\n\n- **Simple Routes**: Direct paths between start and goal points\n- **Waypoint Routes**: Paths that pass through specific intermediate points\n- **Natural Language Routes**: Routes defined using human-readable addresses instead of coordinates\n\n### API Features\n\nThis MCP server provides the following Naver Maps API features:\n\n- **Geocoding**: Convert addresses to coordinates (latitude, longitude)\n- **Reverse Geocoding**: Convert coordinates to addresses\n- **Place Search**: Search places based on keywords\n- **Route Search**: Provide optimal routes between two points\n- **Route Search with Waypoints**: Provide optimal routes including waypoints\n- **Natural Language Route Search**: Convert natural language addresses to coordinates and provide optimal routes\n- **Natural Language Route Search with Waypoints**: Convert natural language addresses (including waypoints) to coordinates and provide optimal routes\n- **Coordinate System Conversion**: Convert between various coordinate systems\n\n## API\n\n### Tools\n\n#### geocode\n\n- **Description**: Convert addresses to coordinates (latitude, longitude)\n- **Input**:\n  - `address` (string): The address to geocode\n  - `filter` (string, optional): Region filter\n- **Output**: Geocoding results including coordinates\n- **Example**:\n  ```json\n  {\n    \"address\": \"서울특별시 강남구 테헤란로 129\"\n  }\n  ```\n\n#### reverseGeocode\n\n- **Description**: Convert coordinates to addresses\n- **Input**:\n  - `latitude` (number): Latitude coordinate\n  - `longitude` (number): Longitude coordinate\n  - `coords_type` (string, optional): Coordinate system type\n- **Output**: Address information for the given coordinates\n- **Example**:\n  ```json\n  {\n    \"latitude\": 37.5058,\n    \"longitude\": 127.0556\n  }\n  ```\n\n#### searchPlaces\n\n- **Description**: Search places based on keywords\n- **Input**:\n  - `query` (string): Search keyword\n  - `coordinate` (object, optional): Center coordinate for search\n  - `radius` (number, optional): Search radius in meters\n- **Output**: List of matching places with their information\n\n#### getDirections\n\n- **Description**: Provide optimal routes between two points\n- **Input**:\n  - `start` (object): Starting coordinates with latitude and longitude\n  - `goal` (object): Goal coordinates with latitude and longitude\n  - `option` (string, optional): Route option (trafast, tracomfort, etc.)\n  - `lang` (string, optional): Guide language\n- **Output**: Route information including path, summary, and guide\n- **Example**:\n  ```json\n  {\n    \"start\": {\n      \"latitude\": 37.5058,\n      \"longitude\": 127.0556\n    },\n    \"goal\": {\n      \"latitude\": 37.5662,\n      \"longitude\": 126.9784\n    },\n    \"option\": \"trafast\"\n  }\n  ```\n\n#### getDirectionsWithWaypoints\n\n- **Description**: Provide optimal routes including waypoints\n- **Input**:\n  - `start` (object): Starting coordinates\n  - `goal` (object): Goal coordinates\n  - `waypoints` (array, optional): List of waypoint coordinates\n  - `option` (string, optional): Route option\n- **Output**: Route information with waypoints included\n\n#### getDirectionsByNaturalLanguage\n\n- **Description**: Convert natural language addresses to coordinates and provide optimal routes\n- **Input**:\n  - `startAddress` (string): Starting address as natural language\n  - `goalAddress` (string): Goal address as natural language\n  - `option` (string, optional): Route option\n  - `lang` (string, optional): Guide language\n- **Output**: Route information with original address data\n- **Example**:\n  ```json\n  {\n    \"startAddress\": \"서울특별시 강남구 테헤란로 129\",\n    \"goalAddress\": \"서울특별시 중구 명동\",\n    \"option\": \"trafast\"\n  }\n  ```\n\n#### getDirectionsWithWaypointsByNaturalLanguage\n\n- **Description**: Convert natural language addresses (including waypoints) to coordinates and provide optimal routes\n- **Input**:\n  - `startAddress` (string): Starting address as natural language\n  - `goalAddress` (string): Goal address as natural language\n  - `waypointAddresses` (array, optional): List of waypoint addresses\n  - `option` (string, optional): Route option\n- **Output**: Route information with waypoints and original address data\n- **Example**:\n  ```json\n  {\n    \"startAddress\": \"서울특별시 강남구 테헤란로 129\",\n    \"goalAddress\": \"서울특별시 중구 명동\",\n    \"waypointAddresses\": [\"서울특별시 용산구 남산\", \"서울특별시 중구 시청\"],\n    \"option\": \"trafast\"\n  }\n  ```\n\n#### transformCoordinates\n\n- **Description**: Convert between various coordinate systems\n- **Input**:\n  - `coords` (object): Coordinates to transform\n  - `fromCoordSys` (string): Source coordinate system\n  - `toCoordSys` (string): Target coordinate system\n- **Output**: Transformed coordinates\n\n## Getting Started\n\n### Prerequisites\n\n- Node.js 18.0.0 or higher\n- Naver Cloud Platform API credentials (Client ID, Client Secret)\n\n### Installation\n\n1. Install globally from npm:\n\n```bash\nnpm install -g @devyhan/naver-maps-mcp\n```\n\nOr run directly using npx:\n\n```bash\nnpx @devyhan/naver-maps-mcp\n```\n\n2. Set up environment variables (recommended):\n\n```bash\ncp .env.example .env\n```\n\nEdit the `.env` file to enter your Naver API authentication information:\n\n```\nNAVER_CLIENT_ID=your_client_id_here\nNAVER_CLIENT_SECRET=your_client_secret_here\n```\n\n3. Set API credentials directly when running:\n\n```bash\nNAVER_CLIENT_ID=your_client_id NAVER_CLIENT_SECRET=your_client_secret npx @devyhan/naver-maps-mcp\n```\n\n4. Use programmatically in your application:\n\n```javascript\nimport naverMapsMcp from '@devyhan/naver-maps-mcp';\n\n// Initialize with credentials\nnaverMapsMcp.initNaverMapsClient({\n  clientId: 'your_client_id',\n  clientSecret: 'your_client_secret'\n});\n\n// Start the MCP server\nnaverMapsMcp.startNaverMapsMCP();\n```\n\n### Running\n\n```bash\nnpm start\n```\n\n### Testing\n\n```bash\nnpm test\n```\n\n### Testing with MCP Inspector\n\nYou can test the server using MCP Inspector:\n\n```bash\nnpx @modelcontextprotocol/inspector node index.js\n```\n\n## Usage with Claude Desktop\n\n### Setup\n\nTo use this server with Claude Desktop, add this to your `claude_desktop_config.json`:\n\n#### NPX\n\n```json\n{\n  \"mcpServers\": {\n    \"naverMaps\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@devyhan/naver-maps-mcp\"],\n      \"env\": {\n        \"NAVER_CLIENT_ID\": \"your_client_id_here\",\n        \"NAVER_CLIENT_SECRET\": \"your_client_secret_here\"\n      }\n    }\n  }\n}\n```\n\n#### Docker\n\n```json\n{\n  \"mcpServers\": {\n    \"naverMaps\": {\n      \"command\": \"docker\",\n      \"args\": [\"run\", \"-i\", \"--rm\", \"devyhan/naver-maps-mcp\"],\n      \"env\": {\n        \"NAVER_CLIENT_ID\": \"your_client_id_here\",\n        \"NAVER_CLIENT_SECRET\": \"your_client_secret_here\"\n      }\n    }\n  }\n}\n```\n\n### Environment Variables\n\nThe server can be configured using the following environment variables:\n\n- `NAVER_CLIENT_ID`: Your Naver Cloud Platform Client ID\n- `NAVER_CLIENT_SECRET`: Your Naver Cloud Platform Client Secret\n- `PORT`: Server port (default: 3000)\n- `LOG_LEVEL`: Logging level (error, warn, info, debug)\n\nAfter setting up, restart Claude Desktop.\n\n## Building\n\n### Docker\n\nBuild a Docker image:\n\n```bash\ndocker build -t devyhan/naver-maps-mcp .\n```\n\n## Project Structure\n\n```\nnaver-maps-mcp/\n├── index.js              # Entry point\n├── package.json          # Project metadata\n├── .env.example          # Environment variables example\n├── README.md             # Project documentation\n├── src/\n│   ├── server.js         # MCP server implementation\n│   ├── api/\n│   │   └── naverMapsClient.js  # Naver API client\n│   └── utils/\n│       ├── config.js     # Configuration management\n│       └── logger.js     # Logging utility\n└── tests/\n    └── test.js           # Test code\n```\n\n## License\n\nISC\n\n## References\n\n- [Model Context Protocol](https://modelcontextprotocol.io/)\n- [Naver Cloud Platform Maps API](https://api.ncloud-docs.com/docs/application-maps-overview)\n","readmeFilename":"README.md"}