使用说明

项目简介

Mapbox MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型 (LLM) 应用提供地图相关的地理空间服务。该服务器集成了 Mapbox API，提供了地理编码、路线规划和距离矩阵计算等功能，使 LLM 应用能够轻松地利用地图数据和地理位置信息。

主要功能点

地理编码 (Geocoding): 根据地名或地址查询经纬度坐标和详细地理信息。
路线规划 (Directions): 计算两点或多地点之间的导航路线，支持多种出行方式（驾车、步行、骑行等），并提供详细的路线步骤、距离和预计时间。
距离矩阵 (Matrix): 批量计算多个地点之间的旅行时间和距离矩阵，用于分析和优化地理空间关系。
工具集成: 通过 MCP 协议将 Mapbox API 的功能封装成标准化的工具，方便 LLM 客户端调用。
易于集成: 提供 Claude Desktop 集成配置示例，可轻松接入支持 MCP 协议的 LLM 客户端。

安装步骤

安装 Node.js 和 TypeScript: 确保你的系统已安装 Node.js 16 或更高版本，以及 TypeScript 4.5 或更高版本。
获取 Mapbox API 密钥: 访问 Mapbox 官网注册并获取有效的 API 密钥。
设置环境变量: 在你的终端中设置 'MAPBOX_ACCESS_TOKEN' 环境变量，将你的 Mapbox API 密钥赋值给它。例如，在 Bash 中运行 'export MAPBOX_ACCESS_TOKEN=your_api_key_here'。
克隆仓库: 使用 'git clone https://github.com/AidenYangX/mapbox-mcp-server.git' 命令克隆仓库到本地。
安装依赖: 进入项目目录，运行 'npm install' 或 'yarn install' 安装项目依赖。
构建项目: 运行 'npm run build' 或 'yarn build' 命令编译 TypeScript 代码。

服务器配置

以下是将 Mapbox MCP Server 集成到 MCP 客户端 (例如 Claude Desktop) 的配置示例。你需要将此配置添加到你的 MCP 客户端的配置文件中。

{
  "mcpServers": {
    "mapbox-mcp-server": {
      "command": "node",
      "args": ["/absolute/path/to/mapbox-mcp-server/build/index.js"], // 将 "/absolute/path/to/mapbox-mcp-server" 替换为你的项目绝对路径
      "env": {
        "MAPBOX_ACCESS_TOKEN": "your-api-key" // 你的 Mapbox API 密钥 (也可以在系统环境变量中设置)
      }
    }
  }
}

基本使用方法

启动服务器: 在项目根目录下，运行 'npm run start' 或 'yarn start' 命令启动 Mapbox MCP Server。
配置 MCP 客户端: 根据 MCP 客户端的文档，配置连接到 Mapbox MCP Server。通常需要提供服务器名称、启动命令和参数。
在 LLM 应用中使用工具: 在你的 LLM 应用中，通过 MCP 协议调用 Mapbox MCP Server 提供的工具，例如 'mapbox_geocoding'、'mapbox_directions' 等，即可使用地图服务功能。具体的工具名称和参数请参考仓库 README.md 文件中 "Features" 部分的工具描述。

关键词

使用说明

信息