Skip to content

v0.1.1 - Claude marketplace plugin

Choose a tag to compare

@severity1 severity1 released this 25 May 01:08

Highlights

  • New distribution channel: Claude marketplace plugin. nz-akahu-mcp is now installable in both Claude Code and Claude Desktop via the severity1 marketplace, in addition to the existing uvx nz-akahu-mcp PyPI path.
  • No more shell env wrangling. Tokens prompt at install and store in your OS keychain (macOS Keychain on macOS, Windows Credential Manager on Windows). The package itself is unchanged.

Install (preferred)

In Claude Code:

/plugin marketplace add severity1/severity1-marketplace
/plugin install nz-akahu-mcp@severity1-marketplace

In Claude Desktop: Cowork -> Plugins -> Add marketplace -> severity1/severity1-marketplace -> Install nz-akahu-mcp.

Known issue: Claude Desktop's install-time prompt may not fire (anthropics/claude-code#39827). Workaround: use Configure options on the installed plugin after install. The plugin works correctly once configured.

The existing manual install paths (claude mcp add, hand-edited claude_desktop_config.json) are kept in the README under "(manual)" sections for users hacking on source or pinning a git ref.

What's in this release

  • plugin/.claude-plugin/plugin.json - manifest with userConfig for Akahu user/app tokens (sensitive: true) and the read-only / automation-bypass safety flags
  • plugin/.mcp.json - launches uvx nz-akahu-mcp with ${user_config.KEY} substitution into the matching AKAHU_* env vars
  • plugin/README.md - plugin-side install/configure/uninstall guide
  • README.md - marketplace plugin promoted to preferred path; manual sections demoted with redirect callouts
  • PUBLISHING.md - documents the lockstep pyproject.toml + plugin/.claude-plugin/plugin.json version bump now required for releases
  • .gitignore - anchors /.mcp.json to root so plugin/.mcp.json ships with the repo

What did NOT change

  • No changes to the Python package source. The 14 tools, the three-layer write safety, and all behavior are identical to v0.1.0.
  • No new dependencies.
  • No CLI flag changes.

Tested

  • ruff lint clean
  • mypy strict-mode clean
  • 151 pytest tests pass with 100% line + branch coverage