You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/standalone-mcp/build-server.mdx
+13-13Lines changed: 13 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -149,7 +149,7 @@ The generated MCP server includes a comprehensive file structure with TypeScript
149
149
150
150
## Running your MCP server locally
151
151
152
-
You can run your MCP server from the generated code, a published npm package, or the generated Desktop Extensions (DXT) package.
152
+
You can run your MCP server from the generated code, a published npm package, or the generated MCP Bundle (MCPB) package.
153
153
154
154
### Local development setup
155
155
@@ -196,12 +196,12 @@ Once you've published your MCP server to npm (following our [SDK publishing guid
196
196
197
197
**Note:** You must first publish your package to npm before you can test it using this configuration.
198
198
199
-
### Using the generated DXT
199
+
### Using the generated MCPB
200
200
201
-
For the most user-friendly testing experience, use the generated DXT package. Claude Desktop and other MCP clients can load DXT files directly:
201
+
For the most user-friendly testing experience, use the generated MCPB package. Claude Desktop and other MCP clients can load MCPB files directly:
202
202
203
-
-**Locate your generated DXT file** in the output directory (it typically has a `.dxt` extension).
204
-
-**Install the DXT** in your MCP client following the client's installation process.
203
+
-**Locate your generated MCPB file** in the output directory (it typically has a `.mcpb` extension).
204
+
-**Install the MCPB** in your MCP client following the client's installation process.
205
205
-**Configure environment variables** if your server requires authentication.
206
206
207
207
## Advanced configuration
@@ -248,7 +248,7 @@ You can further limit the subset of tools mounted on an MCP server by specifying
248
248
249
249
## Distribution and hosting options
250
250
251
-
Speakeasy generates MCP servers with three primary distribution methods. You can distribute your server as an npm package, a Cloudflare Worker, or a DXT file. These methods aren't mutually exclusive — most customers use all three approaches to serve different use cases.
251
+
Speakeasy generates MCP servers with three primary distribution methods. You can distribute your server as an npm package, a Cloudflare Worker, or an MCPB file. These methods aren't mutually exclusive — most customers use all three approaches to serve different use cases.
252
252
253
253
### Distribute your MCP server on npm
254
254
@@ -286,28 +286,28 @@ Cloudflare hosting enables OAuth authentication flows and eliminates the need fo
286
286
287
287
Follow the [Cloudflare deployment guide](/docs/standalone-mcp/cloudflare-deployment) for detailed instructions on using Cloudflare hosting.
288
288
289
-
### Generate your MCP server as a DXT file
289
+
### Generate your MCP server as an MCPB file
290
290
291
-
In addition to a drag-and-drop experience for end users (particularly in Claude Desktop), DXT provides the following benefits:
291
+
In addition to a drag-and-drop experience for end users (particularly in Claude Desktop), MCPB provides the following benefits:
292
292
293
293
-**User-friendly installation:** Drag-and-drop installation in Claude Desktop.
294
294
-**Guided setup:** Nicely prompts end-users for API keys and auth credentials.
295
295
-**Self-contained format:** All dependencies and metadata bundled together.
296
296
-**Cross-platform compatibility:** Works across different operating systems and MCP clients.
297
297
298
-
Speakeasy automatically generates [Anthropic Desktop Extensions (`.dxt` files)](https://github.com/anthropics/dxt) as part of MCP server generation. The DXT includes:
298
+
Speakeasy automatically generates [MCP Bundle (`.mcpb` files)](https://github.com/anthropics/dxt) as part of MCP server generation. The MCPB includes:
299
299
300
300
-**A `manifest.json` file**, containing metadata describing your MCP server
301
301
-**All the necessary server files**, packaged for distribution
302
302
-**Tool descriptions and parameters**, automatically inferred from your OpenAPI document
303
303
-**Icon and branding assets**, if provided
304
304
305
-
You can customize the generated DXT manifest through the `gen.yaml` configuration file:
305
+
You can customize the generated MCPB manifest through the `gen.yaml` configuration file:
306
306
307
307
```yaml
308
308
targets:
309
309
mcp-typescript:
310
-
dxtManifestOverlay:
310
+
mcpbManifestOverlay:
311
311
icon: "https://example.com/my-icon.png"
312
312
displayName: "My Custom API Tools"
313
313
description: "Custom description for my MCP server"
@@ -328,8 +328,8 @@ When building MCP servers with Speakeasy:
328
328
- **Test thoroughly:** Verify that your MCP server works with different clients.
329
329
- **Version your APIs:** Use semantic versioning for your OpenAPI documents.
330
330
- **Monitor performance:** Track the usage and performance of your MCP tools.
331
-
- **Provide clear branding:** Include a `.png` icon file in your project for automatic [DXT](https://www.anthropic.com/engineering/desktop-extensions) icon detection.
332
-
- **Customize DXT metadata:** Use `dxtManifestOverlay` in `gen.yaml` to provide custom display names and descriptions.
331
+
- **Provide clear branding:** Include a `.png` icon file in your project for automatic [MCPB](https://www.anthropic.com/engineering/desktop-extensions) icon detection.
332
+
- **Customize MCPB metadata:** Use `mcpbManifestOverlay` in `gen.yaml` to provide custom display names and descriptions.
0 commit comments