project-structure

Instruction file imported from zuharz/bamboo-mcp-unofficial (.cursor/rules/project-structure.mdc). Copyright stays with the author.

BambooHR MCP Server Project Structure

Main Entry Points

• src/bamboo-mcp.ts - Main MCP server implementation
• src/bamboo-client.ts - BambooHR API client with caching
• src/formatters.ts - Response formatting utilities
• src/types.ts - TypeScript type definitions

Configuration Files

• manifest.json - DXT extension manifest (see dxt-manifest-patterns rule)
• package.json - Project metadata and dependencies
• tsconfig.json - TypeScript configuration
• eslint.config.js - ESLint configuration with security rules
• jest.config.js - Jest testing configuration

Testing

• test/security.test.ts - Security-focused test suite
• test/smoke.test.ts - Basic functionality tests

Build and Scripts

• scripts/build.sh - Build script for DXT packaging
• dist/ - Compiled output directory (auto-generated)

Git Hooks

• .githooks/pre-commit - Pre-commit validation
• .githooks/pre-push - Pre-push validation

DXT Package Structure

When packaged as .dxt:

bamboohr-mcp-1.0.0.dxt/
├── manifest.json        # Extension metadata
├── dist/               # Compiled TypeScript
├── node_modules/       # Production dependencies
└── icon.png           # Extension icon

Related Cursor Rules

• git-commit-policy - CRITICAL: Git commit permission requirements
• code-quality-standards - CRITICAL: Linting, formatting, and NO EMOJIS policy
• dxt-manifest-patterns - DXT manifest configuration
• mcp-server-patterns - MCP implementation patterns
• security-requirements - Security best practices
• testing-requirements - Test coverage goals
• dxt-development-workflow - Build and deployment