Geoapify MCP Server
공식Geoapify MCP Server는 AI 어시스턴트와 에이전트에 지오코딩, 지도, 장소 검색, 경로 탐색, 거리 행렬, 위치 인텔리전스를 제공합니다. OpenStreetMap 기반의 글로벌 지리공간 데이터로 위치 인지 애플리케이션을 구축하세요.
Geoapify MCP(으)로 무엇을 할 수 있나요?
- 지오코딩 주소 및 장소 — 어시스턴트에게 자유 형식 주소, 랜드마크 또는 도시 이름을 좌표로 변환하도록 요청하세요.
- 역지오코딩 좌표 — 위도와 경도를 인근 주소 또는 장소 설명으로 변환하세요.
- 주변 장소 검색 — 주어진 좌표 주변에서 특정 카테고리의 장소를 찾고, 카테고리 탐색 기능을 지원합니다.
- 경로 및 이동 비용 계산 — 구간별 이동 시간과 거리가 포함된 상세 경로를 얻거나, 여러 출발지-목적지 쌍을 비교하세요.
- 지리적 지오메트리 조작 — GeoJSON 지오메트리 간의 공간 관계를 결합, 변환, 측정 또는 평가하세요.
호스팅형 MCP 서버
npx add-mcp 'https://api.geoapify.com/v1/mcp'Claude Code, Codex, Cursor 등에 설치됩니다
문서
MCP 도구
위치 데이터를 검색, 경로 탐색, 처리하는 11가지 도구입니다.
| 도구 | 사용 시점 | 카테고리 | 문서 |
|---|---|---|---|
| geocode_address | 입력이 하나의 자유 형식 주소, 랜드마크, 도시 또는 장소 쿼리이고 좌표가 필요할 때 사용합니다. 지침 - 주소 구성 요소가 이미 분리된 경우 geocode_structured_address를 사용하세요. - 입력이 좌표인 경우 Reverse_geocode_coordinates를 사용하세요. | 지오코딩 | 보기 |
| geocode_structured_address | 도로명, 도시, 우편번호, 국가와 같은 주소 구성 요소가 이미 분리되어 있을 때 사용합니다. 지침 - 하나의 자유 형식 쿼리에는 geocode_address를 사용하세요. - housenumber가 제공되면 street를 포함하세요. | 지오코딩 | 보기 |
| reverse_geocode_coordinates | 위도와 경도를 알고 있고 인근 주소나 장소가 필요할 때 사용합니다. 지침 입력이 주소 텍스트인 경우 geocode_address 또는 geocode_structured_address를 사용하세요. | 지오코딩 | 보기 |
| search_places | 알려진 좌표 주변에서 지원되는 정확한 카테고리 하나의 장소를 찾을 때 사용합니다. 지침 - 카테고리를 모를 때 먼저 list_place_categories를 호출하세요. - 검색 중심이 아직 좌표가 아닌 경우 먼저 주소를 지오코딩하세요. | 장소 | 보기 |
| list_place_categories | search_places에 필요한 정확한 카테고리 값을 확인하려면 이 무료 크레딧 도구를 사용하세요. 지침 - 인수를 받지 않으며 카테고리 이름만 반환합니다. - 이후 search_places를 사용하여 실제 장소를 찾으세요. | 장소 | 보기 |
| calculate_route | 총 비용과 구간별 이동 비용, 선택적 지오메트리 또는 회전 지침이 포함된 하나의 순서 있는 경로에 사용합니다. 지침 여러 소스-대상 쌍의 이동 시간과 거리를 비교하려면 calculate_route_matrix를 대신 사용하세요. | 경로 탐색 | 보기 |
| calculate_route_matrix | 여러 소스와 대상 간의 쌍별 이동 시간과 거리를 비교할 때 사용합니다. 지침 - 경로 지오메트리나 지침은 반환하지 않습니다. - 하나의 상세한 순서 있는 경로에는 calculate_route를 사용하세요. | 경로 탐색 | 보기 |
| combine_geometries | GeoJSON 입력을 교차, 차집합, 합집합 또는 외곽선 처리하여 새 지오메트리를 만들 때 사용합니다. 지침 - 불리언 관계에는 evaluate_spatial_relation을 사용하세요. - 숫자 측정에는 Measure_geometry를 사용하세요. - 하나의 지오메트리를 수정하려면 Transform_geometry를 사용하세요. | 유틸리티 | 보기 |
| evaluate_spatial_relation | 답이 참 또는 거짓이어야 할 때 사용합니다: 포함, 교차, 분리, 교집합, 유효성, 포함 관계, 또는 점이 선 위에 있는지 여부. 지침 지오메트리를 수정하거나 거리를 계산하지 않습니다. | 유틸리티 | 보기 |
| measure_geometry | 숫자 면적, 길이 또는 거리 계산과 경계 상자, 선을 따른 지점 또는 최근접 지점 결과에 사용합니다. 지침 참/거짓 조건에는 evaluate_spatial_relation을, 지오메트리 수정에는 transform_geometry를 사용하세요. | 유틸리티 | 보기 |
| transform_geometry | 버퍼링, 단순화, 회전, 크기 조정 또는 이동으로 수정된 지오메트리를 만들거나 중심점을 계산할 때 사용합니다. 지침 숫자 측정에는 measure_geometry를, 참/거짓 조건에는 evaluate_spatial_relation을 사용하세요. | 유틸리티 | 보기 |
즐겨 사용하는 도구와 함께 사용하기
몇 분 안에 Geoapify MCP에 연결하세요.
Claude Code 터미널에서 원격 Geoapify 서버를 추가하세요.가이드 보기 ChatGPT 사용자 지정 MCP 서버에 대해 지원되는 인증 옵션을 검토하세요.가이드 보기 VS Code + Copilot VS Code 작업 영역에서 Geoapify MCP를 구성하세요.가이드 보기 Cursor Cursor를 Geoapify 원격 MCP 엔드포인트에 연결하세요.가이드 보기 기타 클라이언트 원격 Streamable HTTP 서버를 지원하는 모든 클라이언트를 사용하세요.가이드 보기
자체 API 키 사용 기존 Geoapify 프로젝트 키로 연결하세요.
맞춤형 도구 카탈로그 에이전트가 런타임에 필요한 도구만 로드하세요.
Streamable HTTP 표준 원격 MCP 전송을 사용하세요.
MCP 추가 요금 없음 도구 호출은 기본 Geoapify API 가격을 따릅니다.
기계 판독 가능한 계약이 필요하신가요?MCP OpenAPI 사양 열기