Mapbox MCP 서버

Mapbox API를 위한 MCP 서버.

특징

탐색 도구

mapbox_directions
- 좌표 간 길찾기
- 입력:
  - coordinates ({위도: 숫자, 경도: 숫자}[])
  - profile (선택 사항): "운전-교통", "운전", "도보", "자전거"
- 반환: 단계, 거리, 소요 시간이 포함된 경로 세부 정보
mapbox_directions_by_places
- 장소 이름을 사용하여 장소 간 경로를 확인하세요.
- 입력:
  - places (string[]): 장소 이름 배열
  - profile (선택 사항): "운전-교통", "운전", "도보", "자전거"
  - language (선택 사항): 두 글자 언어 코드(예: "zh", "en")
- 보고:
  - 각 장소에 대한 지오코딩 결과
  - 단계, 거리, 소요 시간이 포함된 경로 세부 정보
  - 처리 중 발생한 오류
mapbox_matrix
- 좌표 간 이동 시간 및 거리 행렬 계산
- 입력:
  - coordinates ({위도: 숫자, 경도: 숫자}[])
  - profile (선택 사항): "운전", "도보", "자전거"
  - annotations (선택 사항): "기간", "거리", "기간,거리"
  - sources (선택 사항): 소스 좌표의 인덱스
  - destinations (선택 사항): 목적지 좌표의 인덱스
- 반환: 지점 간 지속 시간 및/또는 거리의 행렬
mapbox_matrix_by_places
- 장소 이름을 사용하여 장소 간 이동 시간 및 거리 행렬을 계산합니다.
- 입력:
  - places (string[]): 장소 이름 배열(2~25개 장소)
  - profile (선택 사항): "운전", "도보", "자전거"
  - annotations (선택 사항): "기간", "거리", "기간,거리"
  - language (선택 사항): 두 글자 언어 코드
  - sources (선택 사항): 출처 장소의 인덱스
  - destinations (선택 사항): 목적지 장소의 인덱스
- 보고:
  - 각 장소에 대한 지오코딩 결과
  - 기간 및/또는 거리의 행렬
  - 처리 중 발생한 오류

검색 도구

mapbox_geocoding
- 장소를 검색하고 주소를 좌표로 변환합니다.
- 입력:
  - searchText (문자열): 검색할 장소 또는 주소
  - limit (선택 사항): 최대 결과 수(1-10)
  - types (선택 사항): 장소 유형(국가, 지역, 장소 등)으로 필터링합니다.
  - language (선택 사항): 두 글자 언어 코드
  - fuzzyMatch (선택 사항): 퍼지 매칭을 활성화/비활성화합니다.
- 반환: 좌표 및 속성을 포함한 자세한 위치 정보

Related MCP server: MCP Server

Claude 데스크톱 통합

Claude Desktop 구성 파일(일반적으로 ~/Library/Application Support/Claude/claude_desktop_config.json 에 위치)에 다음 구성을 추가합니다.

지엑스피1

설정

필수 조건

Node.js 16 이상
TypeScript 4.5 이상
유효한 Mapbox API 키

API 키

여기의 지침에 따라 Mapbox API 키를 받으세요.

API 키를 환경 변수로 설정하세요.

export MAPBOX_ACCESS_TOKEN=your_api_key_here

요금 제한

방향 API: 분당 300개 요청
매트릭스 API:
- 운전/도보/자전거 이용 시 분당 60건의 요청
- 운전 트래픽에 대한 분당 30개 요청
지오코딩 API: 분당 600개 요청

전개

구조

mapbox-mcp-server에서는 다음과 같은 구조를 사용하여 서버의 핸들러를 관리합니다.

src/server/handlers/base.ts : 모든 핸들러에 대한 기본 클래스
src/server/registry.ts : 모든 핸들러에 대한 레지스트리
src/server/main.ts : 서버의 주요 진입점

각 기능 모듈은 다음 구조를 따릅니다.

src/ ├── types/ # Type definitions ├── schemas/ # Zod schemas for validation ├── tools/ │ ├── definitions/ # Tool definitions │ └── handlers/ # Tool implementations └── server/ └── handlers/ # Handler classes

클래스 다이어그램 : mapbox-mcp-서버-클래스-다이어그램