mcp-server-ts-trello

# Trello MCP Server (TypeScript) A TypeScript implementation of a Model Context Protocol (MCP) server for Trello integration, providing tools for AI assistants to interact with Trello boards, lists, and cards. ## Features - Full Trello API integration through MCP tools - Asynchronous operations for better performance - Type-safe implementation using TypeScript - Comprehensive error handling - Environment-based configuration ## Prerequisites - Node.js 18.x or higher - npm or yarn - Trello API credentials ## Installation ```bash # Install dependencies make install ``` ## Configuration Create a `.env` file in the root directory with your Trello credentials: ```env TRELLO_API_KEY=your_api_key TRELLO_TOKEN=your_token ``` ## Available Commands ```bash # Install dependencies make install # Build the project make build # Start the server make start # Clean build artifacts make clean # Run linter make lint ``` ## MCP Tools ### get_boards Retrieves all Trello boards for the authenticated user. ```typescript // No input parameters required ``` ### get_lists Fetches all lists from a specified board. ```typescript { "request": { "board_id": string // ID of the board } } ``` ### get_cards Gets cards from a board or specific list. ```typescript { "request": { "board_id": string, // ID of the board "list_id"?: string // Optional: ID of a specific list } } ``` ### get_card_details Retrieves detailed information about a specific card. ```typescript { "request": { "card_id": string // ID of the card } } ``` ## Development The project uses TypeScript for type safety and better developer experience. The source code is organized as follows: - `src/index.ts` - Main server entry point - `src/trello-client.ts` - Trello API client implementation - `src/types.ts` - TypeScript type definitions ## Building The project uses TypeScript compiler for building: ```bash # Build the project make build # The output will be in the build/ directory ``` ## Error Handling The server implements comprehensive error handling for: - API authentication errors - Rate limiting - Network issues - Invalid request parameters ## Contributing 1. Fork the repository 2. Create your feature branch (`git checkout -b feature/amazing-feature`) 3. Commit your changes (`git commit -m 'Add some amazing feature'`) 4. Push to the branch (`git push origin feature/amazing-feature`) 5. Open a Pull Request ## Using with Cline To use this MCP server with Cline, add the following configuration to your Cline MCP settings file (`~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`): ```json { "mcpServers": { "trello-ts": { "command": "node", "args": ["/path/to/mcp-server-ts-trello/build/index.js"], "env": { "TRELLO_API_KEY": "your_api_key", "TRELLO_TOKEN": "your_token" } } } } ``` After adding the configuration and restarting Cline, you can use the following MCP tools: - `get_boards`: List all Trello boards - `get_lists`: Get lists from a board - `get_cards`: Get cards from a board or list - `get_card_details`: Get detailed card information ## License ISC License - See LICENSE file for details