remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides navigation and geocoding capabilities through the Mapbox API, including routing between coordinates or place names, calculating travel time and distance matrices, and converting place names to coordinates.

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 (선택 사항): 퍼지 매칭을 활성화/비활성화합니다.
- 반환: 좌표 및 속성을 포함한 자세한 위치 정보

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

클래스 다이어그램 :

공정도 :

오류 처리

모든 도구는 포괄적인 오류 처리를 구현합니다.

입력 검증 오류
API 요청 실패
속도 제한 오류
서비스별 오류(예: 경로를 찾을 수 없음, 잘못된 좌표)

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 조건에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools