Skip to main content
Glama

Mapbox MCP 서버

Mapbox API를 위한 MCP 서버.

특징

탐색 도구

  1. mapbox_directions

    • 좌표 간 길찾기

    • 입력:

      • coordinates ({위도: 숫자, 경도: 숫자}[])

      • profile (선택 사항): "운전-교통", "운전", "도보", "자전거"

    • 반환: 단계, 거리, 소요 시간이 포함된 경로 세부 정보

  2. mapbox_directions_by_places

    • 장소 이름을 사용하여 장소 간 경로를 확인하세요.

    • 입력:

      • places (string[]): 장소 이름 배열

      • profile (선택 사항): "운전-교통", "운전", "도보", "자전거"

      • language (선택 사항): 두 글자 언어 코드(예: "zh", "en")

    • 보고:

      • 각 장소에 대한 지오코딩 결과

      • 단계, 거리, 소요 시간이 포함된 경로 세부 정보

      • 처리 중 발생한 오류

  3. mapbox_matrix

    • 좌표 간 이동 시간 및 거리 행렬 계산

    • 입력:

      • coordinates ({위도: 숫자, 경도: 숫자}[])

      • profile (선택 사항): "운전", "도보", "자전거"

      • annotations (선택 사항): "기간", "거리", "기간,거리"

      • sources (선택 사항): 소스 좌표의 인덱스

      • destinations (선택 사항): 목적지 좌표의 인덱스

    • 반환: 지점 간 지속 시간 및/또는 거리의 행렬

  4. mapbox_matrix_by_places

    • 장소 이름을 사용하여 장소 간 이동 시간 및 거리 행렬을 계산합니다.

    • 입력:

      • places (string[]): 장소 이름 배열(2~25개 장소)

      • profile (선택 사항): "운전", "도보", "자전거"

      • annotations (선택 사항): "기간", "거리", "기간,거리"

      • language (선택 사항): 두 글자 언어 코드

      • sources (선택 사항): 출처 장소의 인덱스

      • destinations (선택 사항): 목적지 장소의 인덱스

    • 보고:

      • 각 장소에 대한 지오코딩 결과

      • 기간 및/또는 거리의 행렬

      • 처리 중 발생한 오류

검색 도구

  1. mapbox_geocoding

    • 장소를 검색하고 주소를 좌표로 변환합니다.

    • 입력:

      • searchText (문자열): 검색할 장소 또는 주소

      • limit (선택 사항): 최대 결과 수(1-10)

      • types (선택 사항): 장소 유형(국가, 지역, 장소 등)으로 필터링합니다.

      • language (선택 사항): 두 글자 언어 코드

      • fuzzyMatch (선택 사항): 퍼지 매칭을 활성화/비활성화합니다.

    • 반환: 좌표 및 속성을 포함한 자세한 위치 정보

Related MCP server: Overture Maps MCP

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-서버-클래스-다이어그램


공정도 :mapbox-mcp-서버-프로세스-다이어그램

오류 처리

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

  • 입력 검증 오류

  • API 요청 실패

  • 속도 제한 오류

  • 서비스별 오류(예: 경로를 찾을 수 없음, 잘못된 좌표)

특허

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

Available Tools

5 tools
mapbox_directionsC

Get navigation route between two points

Inputs: coordinates (required), profile.

mapbox_directions_by_placesC

Get navigation route between multiple places using their names

Inputs: places (required), profile, language.

mapbox_geocodingC

Search for places and convert addresses into coordinates

Inputs: searchText (required), limit, types, language, +1 more.

mapbox_matrixC

Calculate travel time and distance matrices between coordinates

Inputs: coordinates (required), profile, annotations, approaches, +5 more.

mapbox_matrix_by_placesC

Calculate travel time and distance matrices between places using their names

Inputs: places (required), profile, annotations, language, +4 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 5 tools

    Disambiguation4/5

    The tools are mostly distinct, with clear purposes like routing, geocoding, and matrix calculations. However, the two directions tools (mapbox_directions and mapbox_directions_by_places) and two matrix tools (mapbox_matrix and mapbox_matrix_by_places) could cause minor confusion as they overlap in functionality but differ in input types (coordinates vs. place names). Descriptions help clarify this distinction.

    Naming Consistency5/5

    All tool names follow a consistent 'mapbox_' prefix with descriptive suffixes (e.g., directions, geocoding, matrix), using snake_case uniformly. The naming pattern is predictable and readable, making it easy for agents to understand the tool's purpose at a glance.

    Tool Count5/5

    With 5 tools, the server is well-scoped for its mapping and navigation domain. Each tool serves a distinct function (e.g., routing, geocoding, matrix calculations), and the count is neither too sparse nor overwhelming, fitting typical use cases effectively.

    Completeness4/5

    The tool set covers core mapping operations like routing, geocoding, and travel time calculations, with good coverage for the domain. A minor gap might be the lack of tools for additional Mapbox services (e.g., static maps or spatial analysis), but the provided tools enable key workflows without significant dead ends.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers