MCP cover image
See in Github
2024-12-23

Miroir dehttps: //github.com/aidenyangx/mapbox-mcp-server

0

Github Watches

1

Github Forks

1

Github Stars

Mapbox MCP Server

MCP Server for the Mapbox API.

Features

Navigation Tools

  1. mapbox_directions

    • Get directions between coordinates
    • Inputs:
      • coordinates ({latitude: number, longitude: number}[])
      • profile (optional): "driving-traffic", "driving", "walking", "cycling"
    • Returns: route details with steps, distance, duration
  2. mapbox_directions_by_places

    • Get directions between places using their names
    • Inputs:
      • places (string[]): Array of place names
      • profile (optional): "driving-traffic", "driving", "walking", "cycling"
      • language (optional): Two-letter language code (e.g., "zh", "en")
    • Returns:
      • Geocoding results for each place
      • Route details with steps, distance, duration
      • Any errors that occurred during processing
  3. mapbox_matrix

    • Calculate travel time and distance matrices between coordinates
    • Inputs:
      • coordinates ({latitude: number, longitude: number}[])
      • profile (optional): "driving", "walking", "cycling"
      • annotations (optional): "duration", "distance", "duration,distance"
      • sources (optional): Indices of source coordinates
      • destinations (optional): Indices of destination coordinates
    • Returns: Matrix of durations and/or distances between points
  4. mapbox_matrix_by_places

    • Calculate travel time and distance matrices between places using their names
    • Inputs:
      • places (string[]): Array of place names (2-25 places)
      • profile (optional): "driving", "walking", "cycling"
      • annotations (optional): "duration", "distance", "duration,distance"
      • language (optional): Two-letter language code
      • sources (optional): Indices of source places
      • destinations (optional): Indices of destination places
    • Returns:
      • Geocoding results for each place
      • Matrix of durations and/or distances
      • Any errors that occurred during processing

Search Tools

  1. mapbox_geocoding
    • Search for places and convert addresses into coordinates
    • Inputs:
      • searchText (string): The place or address to search for
      • limit (optional): Maximum number of results (1-10)
      • types (optional): Filter by place types (country, region, place, etc.)
      • language (optional): Two-letter language code
      • fuzzyMatch (optional): Enable/disable fuzzy matching
    • Returns: Detailed location information including coordinates and properties

Claude Desktop Integration

Add this configuration to your Claude Desktop config file (typically located at ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "mapbox-mcp-server": {
      "command": "node",
      "args": ["/absolute/path/to/mapbox-mcp-server/build/index.js"],
      "env": {
        "MAPBOX_ACCESS_TOKEN": "your-api-key"
      }
    }
  }
}

Setup

Prerequisites

  • Node.js 16 or higher
  • TypeScript 4.5 or higher
  • A valid Mapbox API key

API Key

Get a Mapbox API key by following the instructions here.

Set your API key as an environment variable:

export MAPBOX_ACCESS_TOKEN=your_api_key_here

Rate Limits

  • Directions API: 300 requests per minute
  • Matrix API:
    • 60 requests per minute for driving/walking/cycling
    • 30 requests per minute for driving-traffic
  • Geocoding API: 600 requests per minute

Deployment

Structure

In mapbox-mcp-server, we use the following structure to manage the server's handlers:

  • src/server/handlers/base.ts: Base class for all handlers
  • src/server/registry.ts: Registry for all handlers
  • src/server/main.ts: Main entry point for the server

Each feature module follows this structure:

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

Class Diagram: mapbox-mcp-server-class-diagram


Process Diagram: mapbox-mcp-server-process-diagram

Error Handling

All tools implement comprehensive error handling:

  • Input validation errors
  • API request failures
  • Rate limit errors
  • Service-specific errors (e.g., no routes found, invalid coordinates)

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

相关推荐

  • NiKole Maxwell
  • I craft unique cereal names, stories, and ridiculously cute Cereal Baby images.

  • https://jgadvisorycpa.com
  • This GPT assists in finding a top-rated business CPA - local or virtual. We account for their qualifications, experience, testimonials and reviews. Business operators provide a short description of your business, services wanted, and city or state.

  • https://suefel.com
  • Latest advice and best practices for custom GPT development.

  • Yusuf Emre Yeşilyurt
  • I find academic articles and books for research and literature reviews.

  • https://maiplestudio.com
  • Find Exhibitors, Speakers and more

  • Carlos Ferrin
  • Encuentra películas y series en plataformas de streaming.

  • Joshua Armstrong
  • Confidential guide on numerology and astrology, based of GG33 Public information

  • Emmet Halm
  • Converts Figma frames into front-end code for various mobile frameworks.

  • Elijah Ng Shi Yi
  • Advanced software engineer GPT that excels through nailing the basics.

  • lumpenspace
  • Take an adjectivised noun, and create images making it progressively more adjective!

  • apappascs
  • Découvrez la collection la plus complète et la plus à jour de serveurs MCP sur le marché. Ce référentiel sert de centre centralisé, offrant un vaste catalogue de serveurs MCP open-source et propriétaires, avec des fonctionnalités, des liens de documentation et des contributeurs.

  • ShrimpingIt
  • Manipulation basée sur Micropython I2C de l'exposition GPIO de la série MCP, dérivée d'Adafruit_MCP230XX

  • OffchainLabs
  • Aller la mise en œuvre de la preuve de la participation Ethereum

  • huahuayu
  • Une passerelle API unifiée pour intégrer plusieurs API d'explorateur de blockchain de type étherscan avec la prise en charge du protocole de contexte modèle (MCP) pour les assistants d'IA.

    Reviews

    4 (1)
    Avatar
    user_FsgXRmdI
    2025-04-15

    The MCP APP by sdkim96 is an outstanding tool that has greatly enhanced my productivity. Its intuitive design and user-friendly interface make it a delight to use daily. The app’s seamless integration with other services and its consistent performance are impressive. Highly recommend checking it out at https://mcp.so/server/mcp-app/sdkim96!