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 分