MCP Server Trello

# Changelog All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). ## [1.5.1] - 2025-09-21 ### Fixed - **Build Process**: Fixed the build process by adding a `build` script to `package.json` that runs `bunx tsc`. - **Dockerfile**: Migrated the `Dockerfile` from `pnpm` to `bun`. ### Changed - **README.md**: Updated the `README.md` file with the correct build and test instructions. - **Dependencies**: Removed `pnpm-lock.yaml` and `package-lock.json`. ## [1.5.0] - 2025-09-21 ### Changed - **Complete Node.js → Bun Migration**: Migrated the entire project to the Bun runtime, resulting in a 2.8-4.4x performance boost. - Replaced `@types/node` and `ts-node` with `bun-types` for native Bun support. - Updated build scripts and test commands to use `bun` instead of `node` and `npm`. - Updated `package.json` to reflect the new engine requirement. ### Added - Documentation updated to recommend `bunx` for optimal performance, while maintaining full backward compatibility with `npx` and `pnpx`. ## [1.4.0] - 2025-09-21 ### Added - **Comprehensive Examples**: Added a new `examples` directory with detailed implementations in JavaScript, Python, and TypeScript. - **Extensive Usage Documentation**: Created `usage-examples.md` with over 800 lines of documentation, including: - Advanced workflow examples for sprint management, bug tracking, and release management. - AI integration examples, including a workflow with the Ideogram MCP server. - Best practices for production-ready patterns, error handling, and advanced features like template systems and time tracking. - `.gitignore` updated to exclude `system-metrics.json`. ### Changed - **Version Bump**: Updated `package.json` version from `1.3.1` to `1.4.0`. ## [1.2.0] - 2025-01-07 ### Added - **Comprehensive Checklist Management Tools** - Five new tools for managing Trello checklists: - `get_checklist_items(name)` - Retrieve all items from a checklist by name - `add_checklist_item(text, checkListName)` - Add new items to existing checklists - `find_checklist_items_by_description(description)` - Search checklist items by text content - `get_acceptance_criteria()` - Convenience method for "Acceptance Criteria" checklists - `get_checklist_by_name(name)` - Get complete checklist with completion percentage ### Added - Data Types - `CheckList` interface with id, name, items, and percentComplete fields - `CheckListItem` interface with id, text, complete, and parentCheckListId fields - Type conversion utilities between Trello API types and MCP types ### Added - Documentation - Comprehensive `CHECKLIST_TOOLS.md` documentation with examples and best practices - API reference for all checklist tools - Usage examples and integration guidance ### Changed - **BREAKING**: Refactored from low-level `Server` class to modern `McpServer` class - **BREAKING**: Replaced manual tool registration with `registerTool()` method - **BREAKING**: Updated all tool handlers to use Zod schema validation - Improved error handling with consistent error response format - Enhanced type safety with proper TypeScript types and `as const` assertions ### Added - Dependencies - `zod: ^3.22.4` for runtime schema validation and TypeScript type generation ### Technical Improvements - Modern MCP TypeScript SDK compliance following latest best practices - Automatic tool discovery and registration via SDK - Runtime input validation with descriptive error messages - Cleaner code structure with individual tool registration - Better maintainability for adding/modifying tools ### Fixed - TypeScript compilation errors with proper MCP response types - Consistent error handling across all tools - Proper type assertions for MCP content responses ## [1.1.0] - Previous Release ### Added - Initial MCP server implementation with 18 core Trello tools - Board and workspace management - Card CRUD operations - List management - Activity tracking - Image attachment support - Configuration persistence ### Features - Support for multiple boards and workspaces - Rate limiting for Trello API compliance - Markdown formatting for card details - Environment variable configuration - Docker support --- ## Migration Guide for v1.2.0 ### For Users - No breaking changes for end users - All existing tools continue to work as before - New checklist tools are available immediately - Improved error messages and validation ### For Developers - The internal architecture has been modernized but the external API remains the same - If extending the server, use the new `registerTool()` pattern with Zod schemas - See `CHECKLIST_TOOLS.md` for examples of the new implementation pattern ### New Capabilities - Full checklist lifecycle management - Advanced search capabilities across checklists - Completion tracking and progress monitoring - Seamless integration with existing card and board tools