Mapbox MCP Server

공식

Mapbox API를 통해 지오코딩, POI 검색, 길찾기, 등시선 등 지리공간 인텔리전스를 활용할 수 있습니다.

문서

Mapbox MCP 서버

Mapbox API를 위한 모델 컨텍스트 프로토콜(MCP)을 구현하는 Node.js 서버입니다.

AI 애플리케이션을 위한 지리 공간 인텔리전스 활용

Mapbox MCP 서버는 Mapbox의 포괄적인 위치 인텔리전스 플랫폼에 대한 원활한 접근을 제공하여 모든 AI 에이전트나 애플리케이션을 지리 공간 인식 시스템으로 변환합니다. 이 서버를 통해 AI는 장소를 이해하고 추론하며, 물리적 세계를 탐색하고, 다음과 같은 풍부한 지리 공간 데이터에 접근할 수 있습니다.

글로벌 지오코딩을 통해 주소와 장소 이름을 좌표로 변환하거나 그 반대로 변환
전 세계 수백만 개의 비즈니스, 랜드마크, 장소에 대한 관심 지점(POI) 검색
실시간 교통 정보를 반영한 운전, 도보, 자전거용 복합 교통수단 경로 안내
접근성 분석 및 물류 최적화를 위한 이동 시간 매트릭스
여러 경유지의 최적 방문 순서를 찾는 경로 최적화 (외판원 문제)
깔끔한 경로 시각화를 위해 GPS 궤적을 도로 네트워크에 맞추는 맵 매칭
특정 시간 또는 거리 제약 내에 도달 가능한 영역을 시각화하는 등시선 생성
위치, 경로, 지리 데이터의 시각적 표현을 생성하는 정적 지도 이미지
API 호출 없이 거리, 면적, 방위, 버퍼 및 공간 분석을 수행하는 오프라인 지리 공간 계산

AI 여행 도우미, 물류 최적화 도구, 위치 기반 추천기 또는 "어디"를 이해해야 하는 모든 애플리케이션을 구축하든, Mapbox MCP 서버는 이를 가능하게 하는 공간 인텔리전스를 제공합니다. Claude Desktop 및 VS Code와 같은 인기 클라이언트에서도 활성화할 수 있습니다. 자세한 내용은 아래를 참조하세요.

Mapbox MCP Server Demo

사용법

이 MCP 서버를 사용하려면 Mapbox 액세스 토큰이 필요합니다.

호스팅된 MCP 엔드포인트

빠른 접근을 위해 호스팅된 MCP 엔드포인트를 사용할 수 있습니다.

엔드포인트: https://mcp.mapbox.com/mcp

다양한 클라이언트 및 API 사용에 대한 자세한 설정 지침은 호스팅된 MCP 서버 가이드를 참조하세요.

Mapbox 액세스 토큰을 받으려면:

mapbox.com/signup에서 무료 Mapbox 계정에 가입하세요.
계정 페이지로 이동하세요.
새 토큰을 생성하거나 기본 공개 토큰을 사용하세요.

Mapbox 액세스 토큰에 대한 자세한 내용은 Mapbox 액세스 토큰 문서를 참조하세요.

통합 가이드

다양한 통합을 위한 자세한 설정 지침은 다음 가이드를 참조하세요.

Claude Desktop 설정 - 이 MCP 서버와 작동하도록 Claude Desktop을 구성하는 지침
Goose 설정 - Goose AI 에이전트 프레임워크 설정
VS Code 설정 - Visual Studio Code에서 개발 환경 설정
Cursor AI IDE 설정 - Cursor AI IDE에서 개발 환경 설정
Smolagents 통합 - Smolagents AI 에이전트를 Mapbox 도구에 연결하는 방법을 보여주는 예제
도구 직접 가져오기 - MCP 서버를 실행하지 않고 자체 애플리케이션에서 Mapbox 도구 사용

프롬프트 예제

설정 후 Claude Desktop 또는 다른 MCP 클라이언트에서 다음 프롬프트를 사용해 보세요.

위치 발견

"엠파이어 스테이트 빌딩에서 도보 거리 내에 있는 커피숍 찾기"
"시애틀에서 포틀랜드로 가고 싶은데, 가는 길에 스타벅스가 있나요?"
"보스턴에서 뉴욕까지 가는 경로에 있는 주유소 보여주기"
"타임스 스퀘어 근처에 어떤 레스토랑이 있나요?"

내비게이션 및 여행

"현재 교통 상황을 반영하여 LAX에서 할리우드까지 운전 경로 안내 받기"
"센트럴 파크에서 타임스 스퀘어까지 걸어서 얼마나 걸리나요?"
"러시아워에 택시로 내 호텔(포시즌스)에서 JFK 공항까지 이동 시간 계산하기"

시각화 및 지도

"골든 게이트 브리지에서 피셔맨스 워프까지의 경로와 두 위치에 마커가 표시된 지도 이미지 생성하기"
"주요 랜드마크가 표시된 맨해튼의 위성 보기 보여주기"
"시애틀 시내에서 1마일 이내에 있는 모든 스타벅스 위치를 강조 표시한 지도 생성하기"

분석 및 계획

"차로 포틀랜드 시내에서 30분 이내에 도달할 수 있는 지역 보여주기"
"덴버에 있는 이 3개의 호텔 위치(메리어트, 쉐라톤, 힐튼)와 컨벤션 센터 간의 이동 시간 매트릭스 계산하기"
"샌프란시스코에서 이 3개의 관광 명소(골든 게이트, 뮤지컬 계단, 피셔맨스 워프)를 방문하는 최적의 경로 찾기"
"이 8개 주소의 배송 경로 최적화하기: [주소 목록]"

GPS 및 경로 매칭

"이 GPS 궤적을 정리하고 도로상의 실제 경로 보여주기: [타임스탬프가 있는 좌표 목록]"
"이 기록된 자전거 주행 경로를 자전거 도로 네트워크에 맞추기: [GPS 좌표]"
"이 운전 경로를 도로 네트워크에 매칭하고 교통 혼잡 수준 표시하기"

오프라인 지리 공간 계산

"이 두 좌표 사이의 거리를 마일 단위로 알려주세요."
"이 다각형의 면적을 제곱킬로미터 단위로 계산하세요."
"위도 37.7749°N, 경도 122.4194°W 지점이 이 서비스 지역 다각형 내부에 있나요?"
"샌프란시스코에서 뉴욕까지의 방위는 무엇인가요?"
"런던과 파리 사이의 중간 지점 찾기"
"이 위치 주변에 5마일 버퍼 영역 생성하기"
"이 지역 경계의 중심점 계산하기"
"이 경로 좌표의 경계 상자는 무엇인가요?"
"이 복잡한 다각형을 단순화하여 점의 개수 줄이기"

더 나은 결과를 위한 팁

위치를 구체적으로 지정하세요 (전체 주소 또는 랜드마크 이름 사용)
선호하는 이동 수단을 지정하세요 (운전, 도보, 자전거)
관련된 경우 시간 제약을 포함하세요 ("러시아워에", "오후 3시에")
필요한 경우 특정 출력 형식을 요청하세요 ("지도 이미지로", "JSON 형식으로")

자세한 예제: 다양한 사용 사례와 MCP 인스펙터 테스트 지침이 포함된 경로 따라 검색 프롬프트의 포괄적인 예제는 examples/search-along-route.md를 참조하세요.

리소스

MCP 서버는 정적 참조 데이터를 MCP 리소스로 노출합니다. 리소스는 클라이언트가 도구 호출 없이 직접 참조할 수 있는 읽기 전용 데이터 접근을 제공합니다.

사용 가능한 리소스

Mapbox 카테고리 리소스

URI 패턴: mapbox://categories 또는 mapbox://categories/{language}

카테고리 검색 도구와 함께 사용할 수 있는 전체 카테고리 ID 목록에 접근합니다. 카테고리는 유형별로 검색 결과를 필터링하는 데 사용할 수 있습니다 (예: "restaurant", "hotel", "gas_station").

예제:

mapbox://categories - 기본 (영어) 카테고리 목록
mapbox://categories/ja - 일본어 카테고리 이름
mapbox://categories/es - 스페인어 카테고리 이름

리소스 접근하기:

기본 MCP 리소스 지원이 있는 클라이언트: resources/read MCP 프로토콜 메서드 사용
리소스 지원이 없는 클라이언트: 리소스 URI와 함께 resource_reader_tool 사용

리치 맵 미리보기 (MCP 앱)

static_map_image_tool는 모든 클라이언트가 받는 base64 이미지 외에도 호환 클라이언트에서 대화형 지도 미리보기 패널을 제공합니다.

이 서버는 MCP 앱 프로토콜(@modelcontextprotocol/ext-apps)을 구현하여, 채팅 내에서 직접 자체 포함된 HTML 앱 패널을 렌더링합니다. 지원되는 클라이언트는 전체 화면 토글 기능이 있는 대화형 지도를 표시합니다.

Claude Desktop ✅
GitHub Copilot이 포함된 VS Code ✅
Claude Code ✅
Goose ✅

모든 클라이언트는 프로토콜 지원 여부와 관계없이 base64로 인코딩된 지도 이미지를 받습니다. 대화형 미리보기는 표준 이미지 응답 위에 점진적으로 향상된 기능입니다.

레거시: MCP-UI

이 서버는 임베디드 iframe 미리보기를 위한 초기 공개 사양인 MCP-UI(@mcp-ui/server)에 대한 지원도 유지합니다. MCP 앱이 권장 프로토콜이며, MCP-UI 지원은 이전 버전과의 호환성을 위해 유지됩니다.

MCP-UI는 기본적으로 활성화되어 있습니다. 비활성화하려면 명령줄 플래그로 --disable-mcp-ui를 전달하거나 ENABLE_MCP_UI=false을 설정하세요. 자세한 내용은 MCP-UI 문서를 참조하세요.

CLIENT_NEEDS_RESOURCE_FALLBACK

리소스 폴백 도구 (비준수 클라이언트를 위한 옵트인)

리소스는 대부분의 클라이언트(Claude Desktop, VS Code, MCP Inspector 등)에서 지원되는 핵심 MCP 기능입니다. 그러나 일부 클라이언트(예: smolagents)는 리소스를 전혀 지원하지 않습니다. 이러한 클라이언트를 위해 서버는 리소스와 동일한 콘텐츠를 도구 호출을 통해 제공하는 "리소스 폴백 도구"를 제공할 수 있습니다.

폴백 도구:

resource_reader_tool - URI로 모든 리소스를 읽기 위한 일반 폴백
category_list_tool - 카테고리 목록에 대한 접근 제공 (mapbox://categories)

기본적으로 이러한 도구는 포함되지 않습니다 (클라이언트가 리소스를 지원한다고 가정). 클라이언트가 리소스를 지원하지 않는 경우 폴백 도구를 활성화하세요.

export CLIENT_NEEDS_RESOURCE_FALLBACK=true

설정 시기:

✅ smolagents 또는 리소스 지원이 없는 다른 클라이언트를 사용하는 경우 true로 설정
❌ Claude Desktop, VS Code, MCP Inspector 또는 리소스 지원 클라이언트를 사용하는 경우 설정 해제 (기본값)
❌ 확실하지 않은 경우 설정 해제 (대부분의 클라이언트가 리소스를 지원함)

도구

유틸리티 도구

리소스 리더 도구

기본 MCP 리소스 API를 지원하지 않는 클라이언트를 위해 MCP 리소스에 대한 접근을 제공합니다. 이 도구를 사용하여 카테고리 목록과 같은 리소스를 읽을 수 있습니다.

매개변수:

uri: 읽을 리소스 URI (예: mapbox://categories, mapbox://categories/ja)

사용 예제:

기본 카테고리 읽기: {"uri": "mapbox://categories"}
일본어 카테고리 읽기: {"uri": "mapbox://categories/ja"}

참고: MCP 클라이언트가 기본 리소스를 지원하는 경우, 더 나은 성능을 위해 리소스 API를 직접 사용하는 것이 좋습니다.

오프라인 지리 공간 도구

이러한 도구는 Mapbox API 호출 없이 완전히 오프라인으로 지리 공간 계산을 수행합니다. 정확한 지리 계산을 위해 Turf.js를 사용하며 인터넷 연결 없이도 어디서나 작동합니다.

거리 도구

하버사인 공식을 사용하여 두 지리 좌표 간의 거리를 계산합니다.

기능:

여러 단위 지원: 킬로미터, 마일, 미터, 피트, 해리
정확한 대권 거리 계산
API 호출 불필요

사용 예제: "샌프란시스코(37.7749°N, 122.4194°W)와 뉴욕(40.7128°N, 74.0060°W) 사이의 거리는 얼마인가요?"

포인트 인 폴리곤 도구

점이 다각형 또는 다중 다각형 내부에 있는지 테스트합니다.

기능:

구멍이 있는 복잡한 다각형 처리
다중 다각형 지원
지오펜싱 및 서비스 지역 확인에 유용

사용 예제: "이 배송 주소가 서비스 지역 내에 있나요?"

방위 도구

한 좌표에서 다른 좌표로의 나침반 방향(방위)을 계산합니다.

기능:

도 단위로 방위 반환 (0-360°)
기본 방위 제공 (N, NE, E, SE, S, SW, W, NW)
내비게이션 및 방향 쿼리에 유용

사용 예제: "여기서 공항까지 가려면 어느 방향으로 가야 하나요?"

중간점 도구

대권 경로를 따라 두 좌표 사이의 지리적 중간점을 찾습니다.

기능:

지구 곡면에서 실제 중간점 계산
만남 장소 제안에 유용
장거리 계산을 올바르게 처리

사용 예제: "샌프란시스코와 뉴욕의 중간 지점은 어디인가요?"

중심점 도구

다각형 또는 다중 다각형의 기하학적 중심(중심점)을 계산합니다.

기능:

복잡한 모양 처리
모든 점의 산술 평균 반환
레이블이나 마커 배치에 유용

사용 예제: "이 지역 경계에 대한 마커를 어디에 배치해야 하나요?"

면적 도구

다각형의 면적을 계산합니다.

기능:

여러 단위 지원: 제곱미터, 제곱킬로미터, 에이커, 헥타르, 제곱마일, 제곱피트
지구 표면에서 정확한 면적 계산
모든 크기의 다각형 처리

사용 예제: "이 공원의 면적은 몇 에이커인가요?"

경계 상자 도구

지오메트리를 포함하는 최소 경계 상자(bbox)를 계산합니다.

기능:

점, 선, 다각형 및 다중 다각형 처리
[minLongitude, minLatitude, maxLongitude, maxLatitude] 반환
뷰포트 계산 및 공간 인덱싱에 유용

사용 예제: "이 경로의 경계 상자는 무엇인가요?"

버퍼 도구

점, 선 또는 다각형 주변에 버퍼 영역(다각형)을 생성합니다.

기능:

여러 거리 단위 지원
점 주변에 원형 버퍼 생성
근접 분석 및 영향권 생성에 유용

사용 예제: "이 위치 주변에 5km 버퍼 영역을 보여주세요"

단순화 도구

Douglas-Peucker 알고리즘을 사용하여 선 또는 다각형의 정점 수를 줄입니다.

기능:

세부 수준에 대한 구성 가능한 허용 오차
복잡성을 줄이면서 전체 모양 유지
파일 크기 감소 및 렌더링 성능 향상에 유용
토폴로지 유지 옵션 (자체 교차 방지)

사용 예제: "이 복잡한 경계를 단순화하여 점의 개수를 줄이세요"

Mapbox API 도구

카테고리 목록 도구 (지원 중단됨)

⚠️ 지원 중단됨: 대신 URI mapbox://categories과 함께 resource_reader_tool를 사용하거나, 클라이언트가 MCP 리소스를 지원하는 경우 mapbox://categories 리소스에 직접 접근하세요.

이 도구는 MCP 리소스 또는 resource_reader_tool을 지원하지 않는 클라이언트와의 하위 호환성을 위해 유지됩니다.

매트릭스 도구

Mapbox Matrix API를 사용하여 여러 지점 간의 이동 시간과 거리를 계산합니다. 기능은 다음과 같습니다.

효율적인 일대다, 다대일 또는 다대다 경로 계산
다양한 이동 프로필 지원 (driving-traffic, driving, walking, cycling)
교통 상황을 고려한 출발 시간 지정
거리 및 소요 시간 메트릭을 통한 경로 요약
접근 방식 제어 (curb/unrestricted) 및 허용된 출발 방위 범위

정적 이미지 도구

Mapbox 정적 이미지 API를 사용하여 정적 지도 이미지를 생성합니다. 기능은 다음과 같습니다.

사용자 정의 지도 스타일 (streets, outdoors, satellite 등)
조정 가능한 이미지 크기 및 확대/축소 수준
사용자 정의 색상 및 레이블이 있는 여러 마커 지원
폴리라인 및 다각형을 포함한 오버레이 옵션
지정된 좌표에 자동 맞춤

카테고리 검색 도구

Mapbox Search Box 카테고리 검색 API를 사용하여 카테고리 검색을 수행합니다. 기능은 다음과 같습니다.

카테고리별 관심 지점 검색 (레스토랑, 호텔, 주유소 등)
지리적 근접성 기준 필터링
사용자 정의 가능한 결과 제한
각 결과에 대한 풍부한 메타데이터
다국어 지원

역지오코딩 도구

Mapbox 지오코딩 V6 API를 사용하여 역지오코딩을 수행합니다. 기능은 다음과 같습니다.

지리 좌표를 사람이 읽을 수 있는 주소로 변환
사용자 정의 가능한 세부 수준 (거리, 지역, 도시 등)
유형별 결과 필터링 (주소, poi, 지역 등)
다국어 지원
풍부한 위치 컨텍스트 정보

경로 안내 도구

Mapbox Directions API를 사용하여 경로 안내를 가져옵니다. 기능은 다음과 같습니다.

다양한 경로 프로필 지원: 운전 (실시간 교통 또는 일반), 도보, 자전거
여러 경유지 경로 (2-25개 좌표 쌍)
대체 경로 옵션
경로 주석 (거리, 소요 시간, 속도, 혼잡도)
일정 옵션:
- 운전 및 driving-traffic 프로필에 대한 향후 출발 시간 (depart_at)
- 운전 프로필 전용 희망 도착 시간 (arrive_by)
프로필별 최적화:
- 운전: 차량 크기 제약 (높이, 너비, 무게)
경로 제외 옵션:
- 일반 제외: 페리 노선, 현금 전용 통행료
- 운전 관련 제외: 통행료, 고속도로, 비포장 도로, 터널, 국가 경계, 주 경계
- 사용자 정의 지점 제외 (회피할 최대 50개의 지리적 지점)
GeoJSON 지오메트리 출력 형식

등시선 도구

Mapbox Isochrone API를 사용하여 특정 위치에서 지정된 시간 내에 도달할 수 있는 영역을 계산합니다. 기능은 다음과 같습니다.

다양한 이동 프로필 지원 (운전, 도보, 자전거)
사용자 정의 가능한 이동 시간 또는 거리
다중 등고선 생성 (예: 15, 30, 45분 범위)
선택적 출발 또는 도착 시간 지정
시각화를 위한 색상 사용자 정의

검색 및 지오코딩 도구

Mapbox Search Box 텍스트 검색 API 엔드포인트를 사용하여 POI, 주소, 장소 및 해당 API에서 지원하는 기타 모든 유형을 검색하고 지오코딩합니다. 이 도구는 이전에 ForwardGeocodeTool 및 PoiSearchTool(이 MCP 서버의 이전 버전)에서 제공되던 기능을 단일 도구로 통합합니다.

맵 매칭 도구

Mapbox Map Matching API를 사용하여 GPS 궤적을 도로 네트워크에 맞춥니다. 기능은 다음과 같습니다.

노이즈가 있는 GPS 궤적을 도로 네트워크의 깨끗한 경로로 변환
다양한 이동 프로필 지원 (driving, driving-traffic, walking, cycling)
요청당 최대 100개의 좌표 쌍 처리
속도 기반 정확도 향상을 위한 선택적 타임스탬프
다양한 GPS 품질 수준에 대한 구성 가능한 스냅 반경
경로 주석 (속도 제한, 거리, 소요 시간, 교통 혼잡도)
다중 지오메트리 출력 형식 (GeoJSON, 폴리라인)

사용 예제: "이 GPS 궤적을 정리하고 도로에 맞추세요: [타임스탬프가 있는 좌표]"

최적화 도구

Mapbox Optimization API를 사용하여 여러 위치를 통과하는 최적의 경로를 찾습니다. 기능은 다음과 같습니다.

2-12개 위치에 대한 외판원 문제(TSP) 해결
다양한 이동 프로필 지원 (driving, driving-traffic, walking, cycling)
유연한 시작 및 종료 지점 구성
왕복 또는 편도 여행 최적화
턴바이턴 내비게이션 안내 (선택 사항)
경로 주석 (거리, 소요 시간, 속도)
다중 지오메트리 출력 형식 (GeoJSON, 폴리라인)

사용 예제: "이 5개의 정류장을 방문하는 최적의 경로 찾기: [주소 또는 좌표 목록]"

참고: 고급 기능(시간 창, 용량 제약, 다중 차량)이 포함된 V2 API를 사용할 수 있지만 베타 액세스가 필요합니다. V2 구현은 코드베이스에 포함되어 있지만 기본적으로 등록되지 않습니다.

개발

서버 검사하기

Node.js 사용

# Run the built image
npm run inspect:build

Docker 사용

# Build the Docker image
docker build -t mapbox-mcp-server .

# Run and inspect the server
npx @modelcontextprotocol/inspector docker run -i --rm --env MAPBOX_ACCESS_TOKEN="YOUR_TOKEN" mapbox-mcp-server

새 도구 만들기

npx plop create-tool
# provide tool name without suffix (e.g. Search)

새 버전 릴리스하기

# 1. Bump version in package.json
npm version <new-version> --no-git-tag-version

# 2. Sync version to manifest.json and server.json
npm run sync-manifest

# 3. Prepare CHANGELOG (replaces "Unreleased" with version and date)
npm run changelog:prepare-release <new-version>

# 4. Update package-lock.json
npm install

# 5. Review changes, then commit and tag
git add package.json package-lock.json manifest.json server.json CHANGELOG.md
git commit -m "Release v<new-version>"
git tag v<new-version>
git push && git push --tags

중요: 게시자 워크플로는 package.json 및 server.json 버전이 릴리스 버전과 일치하는지 확인합니다. 버전 업데이트 또는 매니페스트 동기화를 건너뛰면 게시가 실패합니다.

OpenTelemetry 추적

이 MCP 서버는 프로덕션 관측 가능성을 위한 포괄적인 OpenTelemetry 추적을 포함합니다.

빠른 데모

# 1. Copy the example configuration
cp .env.example .env

# 2. Edit .env to add your MAPBOX_ACCESS_TOKEN and configure tracing

# 3. Start Jaeger for local development
npm run tracing:jaeger:start

# 4. Run the server (it will automatically use .env configuration)
npm run inspect:build

# 5. View traces at http://localhost:16686

# 6. Stop Jaeger when done
npm run tracing:jaeger:stop

참고: 서버는 시작 시 .env 파일에서 구성을 자동으로 로드합니다. .env.example 파일에는 여러 관측 가능성 플랫폼에 대한 구성 예제가 포함되어 있습니다.

지원되는 관측 가능성 플랫폼

.env.example에 포함된 구성 예제:

클라우드 제공업체:

☁️ AWS X-Ray
☁️ Azure Monitor (Application Insights)
☁️ Google Cloud Trace

SaaS 플랫폼:

📊 Datadog
📊 New Relic
📊 Honeycomb
📊 모든 OTLP 호환 백엔드

프로덕션 구성

전체 설정 지침은 docs/tracing.md를 참조하세요. 포함 내용:

🔧 플랫폼별 구성 가이드
📊 인증 및 엔드포인트 설정
🎯 사용자 정의 추적 속성 및 컨텍스트
🚀 성능 최적화 (최소 오버헤드)
🔍 문제 해결 및 디버깅

추적 기능:

✅ 구성 로딩 추적 (.env 파일 로딩)
✅ 자동 도구 실행 추적
✅ CloudFront 상관 관계 ID가 포함된 HTTP 요청 계측
✅ 구성 가능한 익스포터 (콘솔, OTLP)
✅ 보안 인식 (데이터 보호, JWT 유효성 검사)
✅ 프로덕션 준비 완료 (1% 미만의 CPU 오버헤드)

기여하기

Mapbox MCP 서버에 대한 기여를 환영합니다! 풀 리퀘스트를 제출하기 전에 CONTRIBUTING.md를 읽어주세요.

전체 표준 및 가이드라인:

CONTRIBUTING.md - 시작하기, PR 프로세스, 빠른 참조
엔지니어링 표준 (docs/engineering_standards.md) - 완전한 코드 품질, 테스트, 문서화 및 협업 표준
Claude Code 가이드 (CLAUDE.md) - Claude Code를 사용하는 기여자를 위한 표준 및 패턴
AI 에이전트 지침 (AGENTS.md) - 다른 AI 코딩 도우미(Cursor, Continue, Aider 등)를 위한 가이드
GitHub Copilot 가이드라인 - GitHub Copilot을 책임감 있게 사용하기 위한 모범 사례

기여자를 위한 빠른 시작

리포지토리를 포크하고 포크한 리포지토리를 클론합니다.
종속성 설치: npm install
코딩 표준에 따라 변경 사항을 적용합니다.
테스트 및 린트 실행: npm test && npm run lint
새로운 기능에 대한 테스트를 추가합니다.
명확한 설명과 함께 풀 리퀘스트를 제출합니다.

모든 기여는 CI 검사 및 코드 검토 프로세스를 통과해야 합니다. 자세한 요구 사항은 docs/engineering_standards.md를 참조하세요.

데이터 사용 및 개인정보 보호

Mapbox API로 전송되는 데이터

MCP 서버 도구를 사용하면 다음 데이터가 사용자 환경에서 Mapbox API로 직접 전송됩니다.

지오코딩 도구: 주소/위치 텍스트, 좌표, 국가/지역 필터
검색 도구: 검색 쿼리, 근접성을 위한 위치 좌표, 카테고리 필터
경로 안내 도구: 시작/종료 좌표, 경유지, 경로 선호도, 차량 제약
매트릭스 도구: 여러 좌표 쌍, 이동 프로필, 출발 시간
정적 지도 도구: 좌표, 확대/축소 수준, 스타일 선호도, 마커 정보
등시선 도구: 출발지 좌표, 시간/거리 매개변수, 이동 프로필

개인정보 보호

로컬 실행: 모든 API 호출은 사용자 환경에서 Mapbox API로 직접 이루어집니다.
토큰 보안: Mapbox API 토큰은 로컬 컴퓨터에 남아 있으며 이 MCP 서버에 의해 전송되거나 저장되지 않습니다.
데이터 저장 없음: 이 MCP 서버는 사용자 데이터나 API 요청을 저장, 기록 또는 수집하지 않습니다.
직접 통신: 사용자와 Mapbox API 사이에 중간 서버가 없습니다.

타사 데이터 사용

Mapbox의 개인정보 보호정책이 API로 전송된 데이터에 적용됩니다: https://www.mapbox.com/legal/privacy/
API 사용: 이러한 도구를 통해 이루어진 모든 요청에는 표준 Mapbox API 약관이 적용됩니다.
데이터 보존: 데이터 보존 정책은 Mapbox 문서를 참조하세요.

지원 및 연락처

MCP 서버 문제

이메일: [email protected]
GitHub 이슈: 버그 및 기능 요청 보고

Mapbox API 관련 질문

Mapbox 지원: https://support.mapbox.com/
문서: https://docs.mapbox.com/
API 상태: https://status.mapbox.com/

유지 관리 약속

이 MCP 서버는 Mapbox, Inc.에서 공식적으로 유지 관리합니다. 다음을 제공합니다.

새로운 Mapbox API 기능에 대한 정기 업데이트
버그 수정 및 보안 업데이트
최신 MCP 프로토콜 버전과의 호환성
GitHub 이슈를 통한 커뮤니티 지원

MIT 라이선스