Mcp Docs Server

io.github.mapbox由 GitHub 账号 mapbox 发布v0.3.2更新于 Nov 3, 2026

AI 可访问 Mapbox 文档、API 参考、样式规范和指南。无需令牌。

AI 翻译由 AI 模型根据下方的原文描述翻译,可能有误。

原文描述

AI access to Mapbox docs, API references, style specs, and guides. No token required.

已验证Streamable HTTP可网页运行知识与记忆开发者工具

概览

Mcp Docs Server 的托管 MCP 服务(mcp-docs.mapbox.com);无需登录;Streamable HTTP;3 个工具。

暂无 AI 概览:以下信息来自注册中心条目和服务本身。

端点
mcp-docs.mapbox.com
最近检查

安装

在 SourceWeft 中

  1. 打开 控制台中的 Mcp Docs Server,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.mapbox%2Fmcp-docs-server/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "docs": {
      "type": "http",
      "url": "https://mcp-docs.mapbox.com/mcp"
    }
  }
}

README

Mapbox MCP Documentation Server

A Model Context Protocol (MCP) server that gives AI assistants instant access to Mapbox documentation and reference materials — no Mapbox access token required.

Quick Start

Hosted (no install required)

Connect directly to the hosted endpoint — nothing to install or maintain:

Claude Code / Claude Desktop / Cursor / VS Code

json
{  "mcpServers": {    "mapbox-docs": {      "url": "https://mcp-docs.mapbox.com/mcp"    }  }}

npx (runs locally, no install)

Claude Code — run claude mcp add:

bash
claude mcp add mapbox-docs -- npx -y @mapbox/mcp-docs-server

Claude Desktop — add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

json
{  "mcpServers": {    "mapbox-docs": {      "command": "npx",      "args": ["-y", "@mapbox/mcp-docs-server"]    }  }}

Cursor / VS Code — add the same mcpServers block to your editor's MCP settings file.


Docker

Build the image:

bash
docker build -t mapbox/mcp-docs-server .

Or pull from the registry:

bash
docker pull mapbox/mcp-docs-server

Claude Desktop / Cursor / VS Code — configure your MCP client to run the container:

json
{  "mcpServers": {    "mapbox-docs": {      "command": "docker",      "args": ["run", "--rm", "-i", "mapbox/mcp-docs-server"]    }  }}

Local (from source)

bash
git clone https://github.com/mapbox/mcp-docs-server.gitcd mcp-docs-servernpm installnpm run build

Claude Desktop / Cursor / VS Code:

json
{  "mcpServers": {    "mapbox-docs": {      "command": "node",      "args": ["/absolute/path/to/mcp-docs-server/dist/esm/index.js"]    }  }}

Tools

get_document_tool — Fetches the full content of a specific Mapbox documentation page by URL. Use this to follow a link from a resource and retrieve the complete page content.

Example prompts:

  • "What Mapbox APIs are available?"
  • "How do I add a custom layer to a Mapbox style?"
  • "What's the latest Mapbox GL JS version?"

batch_get_documents_tool — Fetches multiple Mapbox documentation pages in a single call (max 20). More efficient than calling get_document_tool multiple times. Failed pages include an error message rather than failing the whole batch.

search_mapbox_docs_tool — Searches Mapbox documentation across API reference, GL JS, Help Center, Style Spec, Studio, Search JS, iOS/Android Maps and Navigation SDKs, and Tilesets, returning ranked page URLs and descriptions. Use this to find relevant documentation before fetching full pages with get_document_tool or batch_get_documents_tool.

Example prompts:

  • "Find docs about camera animation"
  • "Search for geocoding API examples"
  • "What documentation exists for custom layers?"

Resources

MCP resources expose reference data that AI assistants can read on demand:

Resource URIContents
resource://mapbox-api-referenceREST API reference docs (endpoints, parameters, rate limits)
resource://mapbox-sdk-docsSDK and client library docs (iOS, Android, Flutter, web)
resource://mapbox-guidesTutorials, how-tos, and guides
resource://mapbox-examplesCode examples, API playgrounds, and interactive demos
resource://mapbox-referenceTilesets, data products, accounts, and pricing reference
resource://mapbox-style-layersStyle layer reference (paint/layout properties for all layer types)
resource://mapbox-streets-v8-fieldsMapbox Streets v8 tileset field reference
resource://mapbox-token-scopesAll available Mapbox token scopes with descriptions
resource://mapbox-layer-type-mappingMapping of Mapbox layer types to their properties

Development

Prerequisites

  • Node.js >= 22
  • npm

Setup

bash
git clone https://github.com/mapbox/mcp-docs-server.gitcd mcp-docs-servernpm install

Commands

bash
npm run build          # Compile TypeScript (ESM + CJS)npm test               # Run test suite (vitest)npm run lint           # ESLintnpm run format         # Prettier checknpm run format:fix     # Prettier auto-fixnpm run inspect:build  # Launch MCP Inspector against built servernpm run inspect:dev    # Launch MCP Inspector against source (tsx)

Architecture

The server is a TypeScript MCP server using @modelcontextprotocol/sdk with a dual ESM/CJS build via tshy.

  • Tools extend BaseTool<InputSchema, OutputSchema> in src/tools/
  • Resources extend BaseResource in src/resources/
  • No Mapbox access token required for documentation tools
  • HTTP requests use a shared httpPipeline with 1-hour caching

Creating a New Tool

  1. Create a directory src/tools/my-tool/
  2. Add MyTool.input.schema.ts (Zod schema), MyTool.output.schema.ts, and MyTool.ts (extends BaseTool)
  3. Register in src/tools/toolRegistry.ts
  4. Add tests in test/tools/my-tool/

Contributing

Please read CONTRIBUTING.md and VISION.md before submitting a pull request. Contributors using AI coding assistants should also review:

  • CLAUDE.md — for Claude Code
  • AGENTS.md — for other AI coding assistants (Cursor, Copilot, Aider, etc.)

License

MIT — see LICENSE

来源:README.md,提交 d1f32cc

工具

3

get_document_tool

Get Mapbox Document Tool

Fetch the full content of a specific Mapbox documentation page by URL. Use this after search_mapbox_docs_tool to follow a link from the search results and retrieve the complete page content. For fetching multiple pages at once, use batch_get_documents_tool instead.

输入参数url必填

batch_get_documents_tool

Batch Get Mapbox Documents Tool

Fetch the full content of multiple Mapbox documentation pages in a single call (max 20). More efficient than calling get_document_tool multiple times. Returns an array of results — failed pages include an error message rather than failing the whole batch.

输入参数urls必填

search_mapbox_docs_tool

Search Mapbox Docs Tool

Search Mapbox documentation by keyword or natural language query. Searches across API reference, GL JS, Help Center, Style Spec, Studio, Search JS, iOS/Android Maps and Navigation SDKs, and Tilesets. Returns ranked results with titles, URLs, and descriptions. Use get_document_tool to fetch the full content of a result page.

输入参数limitquery必填

版本历史

2
  1. v0.3.2最新Nov 3, 2026
  2. v0.3.1Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分