mcp-sunsama: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Development Commands

# Development
bun run dev                 # Run server with .env file
bun run typecheck          # TypeScript type checking
bun run typecheck:watch    # Watch mode type checking
bun run inspect            # MCP Inspector for debugging

# Testing
bun test                   # Run unit tests only
bun test:unit              # Run unit tests only (alias)
bun test:integration       # Run integration tests (requires credentials)
bun test:all               # Run all tests
bun test:watch             # Watch mode for unit tests

# Build and Distribution
bun run build              # Compile TypeScript to dist/
bun run prepublishOnly     # Run build before publish

# Version Management (Changeset)
bun run changeset          # Create new changeset
bun run version            # Apply changesets and update version
bun run release            # Build and publish to npm

Contribution Workflow

IMPORTANT: When making changes that affect package users, always create a changeset.

When to Create a Changeset

• ✅ New user-facing features or tools
• ✅ Bug fixes that affect npm package users
• ✅ API changes or breaking changes
• ✅ Dependency updates that change behavior

When NOT to Create a Changeset

• ❌ Infrastructure/deployment changes (CI/CD, Docker, Smithery config)
• ❌ Internal refactoring with no behavior changes
• ❌ Documentation updates
• ❌ Development tooling changes

Standard Workflow

1. Create a branch: git checkout -b {type}/{short-name}
2. Make changes and test: bun test && bun run typecheck
3. Create a changeset: bun run changeset (if changes affect users)
4. Commit with conventional format: git commit -m "fix: description"
5. Push and create PR

See CONTRIBUTING.md for full details.

Architecture Overview

Dual Transport MCP Server

This server supports two transport modes with different authentication strategies: