mcp-docs-server

Mapbox MCP ドキュメントサーバー

AI アシスタントが Mapbox のドキュメントやリファレンス資料にすぐアクセスできる Model Context Protocol (MCP) サーバーです。Mapbox のアクセストークンは不要です。

クイックスタート

ホステッド（インストール不要）

ホステッドエンドポイントに直接接続できます。インストールや保守は不要です。

Claude Code / Claude Desktop / Cursor / VS Code

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

---

npx（ローカルで実行、インストール不要）

Claude Code — claude mcp add を実行します。

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

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加します。

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

Cursor / VS Code — 同じ mcpServers ブロックをエディターの MCP 設定ファイルに追加します。

---

Docker

イメージをビルドします。

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

または、レジストリからプルします。

docker pull mapbox/mcp-docs-server

Claude Desktop / Cursor / VS Code — コンテナを実行するように MCP クライアントを設定します。

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

---

ローカル（ソースから）

git clone https://github.com/mapbox/mcp-docs-server.git
cd mcp-docs-server
npm install
npm run build

Claude Desktop / Cursor / VS Code：

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

ツール

get_document_tool — URL で指定した Mapbox ドキュメントページの全内容を取得します。リソース内のリンク先をたどり、ページの全内容を取得する際に使用します。

プロンプトの例：

• 「利用可能な Mapbox API には何がありますか？」
• 「Mapbox スタイルにカスタムレイヤーを追加する方法を教えてください。」
• 「最新の Mapbox GL JS のバージョンはいくつですか？」

batch_get_documents_tool — 複数の Mapbox ドキュメントページを 1 回の呼び出しで取得します（最大 20 件）。get_document_tool を複数回呼び出すより効率的です。取得に失敗したページにはエラーメッセージが含まれ、バッチ全体が失敗することはありません。

search_mapbox_docs_tool — API リファレンス、GL JS、Help Center、Style Spec、Studio、Search JS、iOS/Android Maps and Navigation SDK、Tilesets を対象に Mapbox ドキュメントを検索し、関連度順にページの URL と説明を返します。get_document_tool または batch_get_documents_tool でページ全体を取得する前に、関連ドキュメントを見つけるために使用します。

プロンプトの例：

• 「カメラアニメーションに関するドキュメントを探してください。」
• 「ジオコーディング API の使用例を検索してください。」
• 「カスタムレイヤーに関するドキュメントには何がありますか？」

リソース

MCP リソースを使うと、AI アシスタントは必要に応じてリファレンスデータを読み取れます。

リソース URI	内容
resource://mapbox-api-reference	REST API リファレンスドキュメント（エンドポイント、パラメーター、レート制限）
resource://mapbox-sdk-docs	SDK とクライアントライブラリのドキュメント（iOS、Android、Flutter、web）
resource://mapbox-guides	チュートリアル、手順、ガイド
resource://mapbox-examples	コード例、API プレイグラウンド、インタラクティブなデモ
resource://mapbox-reference	Tilesets、データ製品、アカウント、料金に関するリファレンス
resource://mapbox-style-layers	スタイルレイヤーのリファレンス（すべてのレイヤータイプの paint/layout プロパティ）
resource://mapbox-streets-v8-fields	Mapbox Streets v8 タイルセットのフィールドリファレンス
resource://mapbox-token-scopes	利用可能なすべての Mapbox トークンスコープと説明
resource://mapbox-layer-type-mapping	Mapbox レイヤータイプとそのプロパティの対応関係

開発

前提条件

• Node.js >= 22
• npm

セットアップ

git clone https://github.com/mapbox/mcp-docs-server.git
cd mcp-docs-server
npm install

コマンド

npm run build          # Compile TypeScript (ESM + CJS)
npm test               # Run test suite (vitest)
npm run lint           # ESLint
npm run format         # Prettier check
npm run format:fix     # Prettier auto-fix
npm run inspect:build  # Launch MCP Inspector against built server
npm run inspect:dev    # Launch MCP Inspector against source (tsx)

アーキテクチャ

このサーバーは @modelcontextprotocol/sdk を使用する TypeScript 製 MCP サーバーで、tshy による ESM/CJS デュアルビルドを採用しています。

• ツールは src/tools/ の BaseTool<InputSchema, OutputSchema> を拡張します
• リソースは src/resources/ の BaseResource を拡張します
• ドキュメントツールで Mapbox のアクセストークンは不要です
• HTTP リクエストでは、1 時間のキャッシュを備えた共有 httpPipeline を使用します

新しいツールの作成

1. ディレクトリ src/tools/my-tool/ を作成します
2. MyTool.input.schema.ts（Zod スキーマ）、MyTool.output.schema.ts、および MyTool.ts（BaseTool を継承）を追加します
3. src/tools/toolRegistry.ts に登録します
4. test/tools/my-tool/ にテストを追加します

貢献

プルリクエストを送信する前に、CONTRIBUTING.md と VISION.md をお読みください。AI コーディングアシスタントを使用するコントリビューターは、次のファイルも確認してください。

• CLAUDE.md — Claude Code 用
• AGENTS.md — その他の AI コーディングアシスタント（Cursor、Copilot、Aider など）用

ライセンス

MIT — LICENSE を参照してください