MCP cover image
See in Github
2024-12-23

MCP服务器的MAPBOX API。

2

Github Watches

6

Github Forks

8

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.

  • Bora Yalcin
  • Evaluator for marketplace product descriptions, checks for relevancy and keyword stuffing.

  • Andris Teikmanis
  • Latvian GPT assistant for developing GPT applications

  • 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.

  • Jan Meindl
  • Builds new GPTs

  • Contraband Interactive
  • Emulating Dr. Jordan B. Peterson's style in providing life advice and insights.

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

  • rustassistant.com
  • Your go-to expert in the Rust ecosystem, specializing in precise code interpretation, up-to-date crate version checking, and in-depth source code analysis. I offer accurate, context-aware insights for all your Rust programming questions.

  • apappascs
  • 发现市场上最全面,最新的MCP服务器集合。该存储库充当集中式枢纽,提供了广泛的开源和专有MCP服务器目录,并提供功能,文档链接和贡献者。

  • ShrimpingIt
  • MCP系列GPIO Expander的基于Micropython I2C的操作,源自ADAFRUIT_MCP230XX

  • OffchainLabs
  • 进行以太坊的实施

  • modelcontextprotocol
  • 模型上下文协议服务器

  • Mintplex-Labs
  • 带有内置抹布,AI代理,无代理构建器,MCP兼容性等的多合一桌面和Docker AI应用程序。

  • huahuayu
  • 统一的API网关,用于将多个Etherscan样区块链Explorer API与对AI助手的模型上下文协议(MCP)支持。

    Reviews

    2 (1)
    Avatar
    user_FylThncd
    2025-04-15

    The yfinance-mcp-server by onori is a game-changer for anyone in need of financial data integration. Its robust features and seamless server capabilities are incredible. Easy to use and integrate, it ensures that I remain on top of market trends effortlessly. Highly recommended!