Skip to content

Commit 1fbdf1d

Browse files
committed
Sync open source content 🐝 (from c8fdab9ebf695cb52b14e635d0e16c63cc55789b)
1 parent a824153 commit 1fbdf1d

File tree

1 file changed

+13
-13
lines changed

1 file changed

+13
-13
lines changed

docs/standalone-mcp/build-server.mdx

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -149,7 +149,7 @@ The generated MCP server includes a comprehensive file structure with TypeScript
149149

150150
## Running your MCP server locally
151151

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.
153153

154154
### Local development setup
155155

@@ -196,12 +196,12 @@ Once you've published your MCP server to npm (following our [SDK publishing guid
196196

197197
**Note:** You must first publish your package to npm before you can test it using this configuration.
198198

199-
### Using the generated DXT
199+
### Using the generated MCPB
200200

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:
202202

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.
205205
- **Configure environment variables** if your server requires authentication.
206206

207207
## Advanced configuration
@@ -248,7 +248,7 @@ You can further limit the subset of tools mounted on an MCP server by specifying
248248

249249
## Distribution and hosting options
250250

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.
252252

253253
### Distribute your MCP server on npm
254254

@@ -286,28 +286,28 @@ Cloudflare hosting enables OAuth authentication flows and eliminates the need fo
286286

287287
Follow the [Cloudflare deployment guide](/docs/standalone-mcp/cloudflare-deployment) for detailed instructions on using Cloudflare hosting.
288288

289-
### Generate your MCP server as a DXT file
289+
### Generate your MCP server as an MCPB file
290290

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:
292292

293293
- **User-friendly installation:** Drag-and-drop installation in Claude Desktop.
294294
- **Guided setup:** Nicely prompts end-users for API keys and auth credentials.
295295
- **Self-contained format:** All dependencies and metadata bundled together.
296296
- **Cross-platform compatibility:** Works across different operating systems and MCP clients.
297297

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:
299299

300300
- **A `manifest.json` file**, containing metadata describing your MCP server
301301
- **All the necessary server files**, packaged for distribution
302302
- **Tool descriptions and parameters**, automatically inferred from your OpenAPI document
303303
- **Icon and branding assets**, if provided
304304

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:
306306

307307
```yaml
308308
targets:
309309
mcp-typescript:
310-
dxtManifestOverlay:
310+
mcpbManifestOverlay:
311311
icon: "https://example.com/my-icon.png"
312312
displayName: "My Custom API Tools"
313313
description: "Custom description for my MCP server"
@@ -328,8 +328,8 @@ When building MCP servers with Speakeasy:
328328
- **Test thoroughly:** Verify that your MCP server works with different clients.
329329
- **Version your APIs:** Use semantic versioning for your OpenAPI documents.
330330
- **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.
333333

334334
## Next steps
335335

0 commit comments

Comments
 (0)