Skip to content

feat(distribution): Claude Desktop .mcpb bundle + one-click MCP install badges#321

Merged
raccioly merged 1 commit into
mainfrom
feat/mcpb-one-click
Jul 16, 2026
Merged

feat(distribution): Claude Desktop .mcpb bundle + one-click MCP install badges#321
raccioly merged 1 commit into
mainfrom
feat/mcpb-one-click

Conversation

@raccioly

Copy link
Copy Markdown
Owner

Summary

Makes DocGuard installable the way each ecosystem expects:

  • Claude Desktop: new build-mcpb release job attaches docguard-v<version>.mcpb to every GitHub Release — the official MCP Bundle format, drag-and-drop into Settings → Extensions with a folder picker for the analyzed project. Recipe verified locally (836 KB bundle, valid manifest, strict 0.3 schema).
  • Cursor / VS Code: one-click MCP deeplink badges in the README.
  • Claude Code / registry: existing claude mcp add one-liner and verified io.github.raccioly/docguard registry namespace, now surfaced together in one README install section.

This is the local-first answer to being "known" in Claude: the Connectors Directory is for remote servers (a hosted DocGuard couldn't see local repos), while .mcpb is Anthropic's curated path for local servers — the bundle also positions us for their extension directory interest form.

Test plan

  • .mcpb packs cleanly with @anthropic-ai/mcpb (validated manifest)
  • 1018/1018 tests, self-guard clean
  • Workflow job mirrors the proven build-extension pattern; runs only on releases

🤖 Generated with Claude Code

…ll badges

- mcpb/manifest.template.json (spec 0.3, strict schema — no comment keys;
  version stamped by CI): node server entry cli/docguard.mjs mcp, directory
  picker user_config for the analyzed project, all six read-only tools
  declared.
- release.yml build-mcpb job: stages the exact npm-pack payload + the one
  production dep, packs with @anthropic-ai/mcpb, attaches
  docguard-v<version>.mcpb to the GitHub Release. Recipe verified locally
  (836 KB bundle, valid manifest).
- README: one-click install badges (Cursor deeplink, VS Code deeplink),
  Claude Desktop drag-and-drop instructions, MCP registry pointer.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@raccioly
raccioly merged commit c7c4ba4 into main Jul 16, 2026
9 checks passed
@raccioly
raccioly deleted the feat/mcpb-one-click branch July 16, 2026 18:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant