Skip to content
Back to search

mcpb

Pack a local MCP server as an MCPB bundle (.mcpb)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/synphonyte--mcpb/badge.svg)](/listings/synphonyte--mcpb)

HTML

<a href="/listings/synphonyte--mcpb"><img src="/api/listings/synphonyte--mcpb/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 55 lines
  1. # mcpb
  2. Pack a local MCP server as an [MCP Bundle](https://github.com/modelcontextprotocol/mcpb) (`.mcpb`): a
  3. zip with a `manifest.json` and the server binary, which clients such as Claude Desktop install with
  4. one click. No Node and no `mcpb` CLI.
  5. ```sh
  6. cargo add mcpb
  7. ```
  8. ```rust
  9. use mcpb::{BundleSpec, DirectoryPrompt, Platform};
  10. let spec = BundleSpec {
  11. name: "my-server".into(),
  12. display_name: None,
  13. version: "1.2.3".into(),
  14. description: "What the server does.".into(),
  15. author: "Me".into(),
  16. platform: Platform::Darwin,
  17. executable: "target/release/my-server".into(),
  18. extra_executables: Vec::new(),
  19. resources: Vec::new(),
  20. tools: vec![("whoami".into(), "Who the caller is.".into())],
  21. directory: Some(DirectoryPrompt {
  22. title: "Project directory".into(),
  23. description: "The directory the server works in.".into(),
  24. }),
  25. args: Vec::new(),
  26. };
  27. spec.pack("dist/my-server-1.2.3-darwin-arm64.mcpb".as_ref())?;
  28. ```
  29. A bundle holds the binary of **one** platform: the manifest can switch the command per operating
  30. system but not per CPU architecture, so each OS/architecture is its own bundle.
  31. `BundleSpec::file_name` names it the way the releases do.
  32. ## Status
  33. Published as [`mcpb`](https://crates.io/crates/mcpb) 0.1.0, which reserves the name; the API is
  34. not stable yet.
  35. Writes the `manifest.json` (version 0.3) and the archive: executables with mode 755, resources with
  36. 644, under a temporary name so a failed pack leaves no partial bundle, and two files that would share
  37. a name in the zip are refused.
  38. Not yet: manifest validation, icons, `server.mcp_config.env`,
  39. `compatibility.platform_overrides`, prompts, localization, and signing (`mcpb sign`/`verify`).
  40. [TODO.md](TODO.md) is the full list, both of what the spec has and what the crate still needs to be
  41. useful on its own.
  42. ## License
  43. MIT — see [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.