krovacloud/krova-node

krova-node MCP server

The single home for the Krova Cloud JavaScript / TypeScript packages — SDK, CLI, MCP server, webhook verifier, and the n8n node. A pnpm-workspace monorepo: the CLI/MCP consume the SDK via workspace:*, so everything stays in sync and a cross-package change is one PR.

Package	npm	What it is
packages/sdk	@krovacloud/sdk	Typed TypeScript SDK for the Krova Cloud API
packages/cli	@krovacloud/cli	The krova CLI (pure Node — built on the SDK)
packages/mcp	@krovacloud/mcp	MCP server for Claude/Cursor/etc.
packages/webhook	@krovacloud/webhook	Outbound-webhook signature verification
packages/n8n-node	n8n-nodes-krova	n8n community node

Develop

pnpm install
pnpm -r build      # topological — the SDK builds before its consumers
pnpm -r test
pnpm -r typecheck

Releasing (automatic, no manual version bumps)

Every push to main runs scripts/release.mjs: for each package that changed since its last release tag, it patch-increments the latest version on npm, publishes it (with provenance), and records a <name>@<version> git tag + GitHub release. Unchanged packages are skipped. An explicit higher version in a package's package.json is honored as-is.

Publishing uses npm trusted publishing (OIDC) — the release workflow has id-token: write and runs pnpm publish --provenance, so no NPM_TOKEN (or any long-lived npm token) is required. See "How releases work" in CONTRIBUTING.md.