Contributing to @rendobar/mcp

April 30, 2026 · View on GitHub

Thanks for your interest. This is a small, focused package — please keep PRs scoped.

Local development

pnpm install
pnpm dev          # tsup watch
pnpm test:watch   # vitest watch
pnpm inspector    # MCP Inspector against your local build

Node 20+ required.

Conventional commits

We use Conventional Commits. Examples:

  • feat: add cancel_job tool
  • fix: handle empty inputs map in submit_job
  • chore(deps): bump @rendobar/sdk to 1.2.0
  • docs: clarify Cursor PATH troubleshooting

The release-please bot reads commits to compute version bumps. Non-conventional commits are silently skipped.

TDD

Every new tool or helper gets a test before the implementation. Run pnpm test:watch while iterating.

House rules

.claude/rules/ contains operational rules for the codebase. Read them before changing tool registration, error mapping, or transport setup.

Reporting bugs

Use GitHub Issues. Include: client name + version, OS, Node version, full server stderr.

License

By contributing, you agree your contributions are licensed under MIT.