Skip to content

Add MCP extension files and update docs#6

Merged
jack-arturo merged 2 commits into
mainfrom
feat/mcpb-support
Jan 10, 2026
Merged

Add MCP extension files and update docs#6
jack-arturo merged 2 commits into
mainfrom
feat/mcpb-support

Conversation

@jack-arturo

Copy link
Copy Markdown
Member

Added manifest.json and mcp-edd.mcpb for MCP extension packaging. Updated README with quick install instructions and new build:extension script in package.json. Added .mcpbignore for packaging exclusions.

Added manifest.json and mcp-edd.mcpb for MCP extension packaging. Updated README with quick install instructions and new build:extension script in package.json. Added .mcpbignore for packaging exclusions.
@coderabbitai

coderabbitai Bot commented Jan 9, 2026

Copy link
Copy Markdown
📝 Walkthrough

Summary by CodeRabbit

  • New Features

    • One-click extension installation for Claude Desktop.
  • Documentation

    • Added a Quick Install section with direct installation instructions and clarified configuration guidance.
  • Chores

    • Added plugin manifest with API credential configuration and listed tool endpoints.
    • Added packaging build script for automated extension creation.
    • Added a development ignore configuration to exclude dev artifacts from packaging/versioning.
    • Updated plugin identifier in server configuration.

✏️ Tip: You can customize this high-level summary in your review settings.

Walkthrough

Adds MCP plugin packaging and configuration for an Easy Digital Downloads integration: new manifest.json describing server entry, env/user config, and tools; a packaging script; a development ignore file; README install instructions; and a small MCP name change in src/index.ts.

Changes

Cohort / File(s) Summary
Plugin Manifest
manifest.json
New MCP manifest declaring plugin metadata, server entry (dist/index.js), MCP config env vars (EDD_API_URL, EDD_API_KEY, EDD_API_TOKEN), user_config schema (edd_api_url, edd_api_key, edd_api_token), a catalog of 12 tools (products, sales, customers, discounts, stats, logs), repository/homepage/license/keywords, and Node >=18.0.0 compatibility.
Build & Packaging
package.json
Added build:extension script: npm run build && npx @anthropic-ai/mcpb pack to build and pack the MCP extension.
Ignore Configuration
.mcpbignore
New ignore file listing patterns to exclude development sources, tests, TypeScript tooling, node_modules, Git/CI artifacts, and other ephemeral files from packaging.
Documentation
README.md
Added "Quick Install (Claude Desktop)" subsection with one-click installation link and clarified wording for manual configuration.
MCP Server ID Change
src/index.ts
Updated MCP server name from mcp-edd to io.github.verygoodplugins/mcp-edd (no logic changes).

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately summarizes the main changes: adding MCP extension configuration files (manifest.json, .mcpbignore) and updating documentation (README, build script).
Description check ✅ Passed The description is directly related to the changeset, covering the addition of manifest.json, .mcpbignore, README updates, and the new build:extension script.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch feat/mcpb-support

📜 Recent review details

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between b57d1f6 and 4da4225.

📒 Files selected for processing (3)
  • README.md
  • manifest.json
  • src/index.ts
✅ Files skipped from review due to trivial changes (1)
  • src/index.ts
🚧 Files skipped from review as they are similar to previous changes (2)
  • README.md
  • manifest.json

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Fix all issues with AI agents
In @manifest.json:
- Around line 46-72: Manifest "name" and package.json "mcpName" are using
different identifiers ("mcp-edd" vs "io.github.verygoodplugins/mcp-edd"); update
one to be canonical so tools surface a single identifier—either change manifest
"name" to "io.github.verygoodplugins/mcp-edd" or change package.json "mcpName"
to "mcp-edd" (whichever is intended), and ensure any references in code/config
that use mcpName or name (e.g., deployment scripts, MCPB/Claude integrations)
are updated to match the chosen canonical identifier.

In @README.md:
- Around line 19-33: Update the README’s “Download mcp-edd.mcpb” link so it
points directly to the release asset URL (the .mcpb file) or change the link
text to make clear it goes to the release page; specifically edit the line
containing the link text "Download mcp-edd.mcpb" to either use the direct asset
download URL for the current release asset or relabel it to "Release page
(download .mcpb asset)" to avoid misleading users and potential 404s.
🧹 Nitpick comments (2)
package.json (1)

22-33: Add @anthropic-ai/mcpb to devDependencies for reproducible builds.

The recommended approach for reproducible builds is to install @anthropic-ai/mcpb as a dev dependency, which automatically locks the version via package-lock.json. Then run the simple npx @anthropic-ai/mcpb pack command (no explicit version pinning needed).

Add to "devDependencies" section:

"@anthropic-ai/mcpb": "<LATEST_VERSION>"

Then update the script:

-    "build:extension": "npm run build && npx @anthropic-ai/mcpb pack",
+    "build:extension": "npm run build && npx @anthropic-ai/mcpb pack",

If the build runs in non-interactive environments (CI), consider adding the --yes flag to suppress prompts, but this is less critical once the package is a locked dev dependency.

.mcpbignore (1)

1-30: Add .env* patterns to prevent accidental credential packaging.

.mcpbignore already supports .gitignore-style patterns including ! negation (as shown by !README.md), so the suggested patterns will work as expected.

Proposed change
 # Other
 *.md
 !README.md
+.env
+.env.*
 .gitignore
 package-lock.json

While no .env files currently exist in the repository, explicitly ignoring .env* follows standard practice for bundled packages to prevent accidental credential leakage if environment files are added later.

📜 Review details

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between c2aa316 and b57d1f6.

📒 Files selected for processing (5)
  • .mcpbignore
  • README.md
  • manifest.json
  • mcp-edd.mcpb
  • package.json
🔇 Additional comments (1)
manifest.json (1)

1-45: The manifest schema and templating are correct. MCPB v0.2 supports both ${__dirname} in args and ${user_config.*} interpolation in env variables, and individual user_config fields use "required": true as shown here—all matching the official specification and examples.

Comment thread manifest.json
Comment thread README.md
Changed the package name in manifest.json and src/index.ts to 'io.github.verygoodplugins/mcp-edd' for consistency and improved identification. Updated README to clarify download instructions.
@jack-arturo jack-arturo merged commit bd531d0 into main Jan 10, 2026
5 checks passed
@jack-arturo jack-arturo deleted the feat/mcpb-support branch January 10, 2026 04:46
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