@mapbox/mcp-docs-server 0.1.0-dev → 0.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +13 -28
- package/dist/commonjs/version.json +3 -3
- package/dist/esm/version.json +3 -3
- package/package.json +3 -1
package/README.md
CHANGED
|
@@ -100,9 +100,7 @@ npm run build
|
|
|
100
100
|
|
|
101
101
|
## Tools
|
|
102
102
|
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
**`get_latest_mapbox_docs_tool`** — Fetches the full Mapbox documentation index from `docs.mapbox.com/llms.txt`. Returns up-to-date, comprehensive coverage of all Mapbox services, APIs, SDKs, and guides in a single LLM-optimized format.
|
|
103
|
+
**`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.
|
|
106
104
|
|
|
107
105
|
Example prompts:
|
|
108
106
|
|
|
@@ -110,36 +108,23 @@ Example prompts:
|
|
|
110
108
|
- "How do I add a custom layer to a Mapbox style?"
|
|
111
109
|
- "What's the latest Mapbox GL JS version?"
|
|
112
110
|
|
|
113
|
-
**`
|
|
114
|
-
|
|
115
|
-
**`explore_mapbox_api_tool`** _(coming soon)_ — Structured, queryable information about Mapbox REST API endpoints. Lists available APIs, operations, required parameters, authentication scopes, and rate limits without making any API calls.
|
|
116
|
-
|
|
117
|
-
**`validate_api_request_tool`** _(coming soon)_ — Validates a Mapbox API request before sending it. Checks required parameters, types, enum values, and token scopes.
|
|
118
|
-
|
|
119
|
-
**`test_api_request_tool`** _(coming soon)_ — Makes real HTTP calls to Mapbox APIs and returns actual responses, with optional code generation in curl, JavaScript, and Python. Requires a Mapbox access token as input.
|
|
120
|
-
|
|
121
|
-
**`get_contextual_docs_tool`** _(coming soon)_ — Retrieves documentation relevant to a specific code context, error message, or technology.
|
|
122
|
-
|
|
123
|
-
### Reference Tools
|
|
124
|
-
|
|
125
|
-
**`get_reference_tool`** — Serves static Mapbox reference documentation directly as tool output (useful for clients that don't support MCP resources). Covers style layers, Streets v8 fields, token scopes, and layer type mappings.
|
|
111
|
+
**`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.
|
|
126
112
|
|
|
127
113
|
## Resources
|
|
128
114
|
|
|
129
115
|
MCP resources expose reference data that AI assistants can read on demand:
|
|
130
116
|
|
|
131
|
-
| Resource URI
|
|
132
|
-
|
|
|
133
|
-
| `resource://mapbox-
|
|
134
|
-
| `resource://mapbox-
|
|
135
|
-
| `resource://mapbox-
|
|
136
|
-
| `resource://mapbox-
|
|
137
|
-
| `resource://mapbox-
|
|
138
|
-
| `resource://mapbox-
|
|
139
|
-
| `resource://mapbox-
|
|
140
|
-
| `resource://mapbox-
|
|
141
|
-
| `resource://mapbox-
|
|
142
|
-
| `resource://mapbox-layer-type-mapping` | Mapping of Mapbox layer types to their properties |
|
|
117
|
+
| Resource URI | Contents |
|
|
118
|
+
| -------------------------------------- | ------------------------------------------------------------------- |
|
|
119
|
+
| `resource://mapbox-api-reference` | REST API reference docs (endpoints, parameters, rate limits) |
|
|
120
|
+
| `resource://mapbox-sdk-docs` | SDK and client library docs (iOS, Android, Flutter, web) |
|
|
121
|
+
| `resource://mapbox-guides` | Tutorials, how-tos, and guides |
|
|
122
|
+
| `resource://mapbox-examples` | Code examples, API playgrounds, and interactive demos |
|
|
123
|
+
| `resource://mapbox-reference` | Tilesets, data products, accounts, and pricing reference |
|
|
124
|
+
| `resource://mapbox-style-layers` | Style layer reference (paint/layout properties for all layer types) |
|
|
125
|
+
| `resource://mapbox-streets-v8-fields` | Mapbox Streets v8 tileset field reference |
|
|
126
|
+
| `resource://mapbox-token-scopes` | All available Mapbox token scopes with descriptions |
|
|
127
|
+
| `resource://mapbox-layer-type-mapping` | Mapping of Mapbox layer types to their properties |
|
|
143
128
|
|
|
144
129
|
## Development
|
|
145
130
|
|
package/dist/esm/version.json
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mapbox/mcp-docs-server",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.2",
|
|
4
4
|
"description": "Mapbox MCP documentation server",
|
|
5
5
|
"mcpName": "io.github.mapbox/mcp-docs-server",
|
|
6
6
|
"main": "./dist/commonjs/index.js",
|
|
@@ -11,6 +11,7 @@
|
|
|
11
11
|
},
|
|
12
12
|
"scripts": {
|
|
13
13
|
"build": "npm run prepare && tshy && npm run generate-version && node scripts/add-shebang.cjs",
|
|
14
|
+
"changelog:prepare-release": "node scripts/prepare-changelog-release.cjs",
|
|
14
15
|
"format": "prettier --check \"./src/**/*.{ts,tsx,js,json,md}\"",
|
|
15
16
|
"format:fix": "prettier --write \"./src/**/*.{ts,tsx,js,json,md}\"",
|
|
16
17
|
"generate-version": "node scripts/build-helpers.cjs generate-version",
|
|
@@ -20,6 +21,7 @@
|
|
|
20
21
|
"lint:fix": "eslint \"./src/**/*.{ts,tsx}\" \"./test/**/*.{ts,tsx}\" --no-error-on-unmatched-pattern --fix",
|
|
21
22
|
"prepare": "node -e \"if(!process.env.CI&&process.env.HUSKY!=='0'){require('child_process').execSync('husky && node .husky/setup-hooks.js',{stdio:'inherit'})}\"",
|
|
22
23
|
"spellcheck": "cspell \"*.md\" \"src/**/*.ts\" \"test/**/*.ts\"",
|
|
24
|
+
"sync-manifest": "node scripts/sync-manifest-version.cjs",
|
|
23
25
|
"test": "vitest"
|
|
24
26
|
},
|
|
25
27
|
"lint-staged": {
|