mcp-server-trello copilot-instructions.md

GitHub Copilot Instructions for MCP Server Trello

This document provides context and guidelines for GitHub Copilot when working with the MCP Server Trello codebase.

Project Overview

MCP Server Trello is a Model Context Protocol (MCP) server that provides tools for interacting with Trello boards. The project is powered by Bun runtime for maximum performance and is written in TypeScript with strict type safety.

Tech Stack

• Runtime: Bun (v1.0.0+), but also compatible with Node.js via npm/npx
• Language: TypeScript 5.3+
• Build Tool: TypeScript Compiler (tsc)
• Primary Dependencies:
  • @modelcontextprotocol/sdk - MCP protocol implementation
  • axios - HTTP client for Trello API
  • zod - Runtime type validation
  • form-data - File upload handling
• Code Quality: ESLint + Prettier
• Testing: Not yet implemented (contributions welcome)

Architecture

Project Structure

src/
├── index.ts                 # Main MCP server implementation and tool registration
├── trello-client.ts         # Trello API client with rate limiting
├── rate-limiter.ts          # Token bucket rate limiter implementation
├── types.ts                 # TypeScript type definitions
├── validators.ts            # Zod schemas for input validation
├── health/                  # Health monitoring endpoints
│   ├── health-endpoints.ts  # Health check MCP tools
│   └── health-monitor.ts    # Health monitoring logic
└── evals/                   # Evaluation tests (using mcp-evals)

Key Components

1. TrelloServer (src/index.ts): Main server class that:

   • Registers MCP tools via registerTool()
   • Handles tool invocations
   • Manages error handling
   • Sets up health monitoring

2. TrelloClient (src/trello-client.ts): API client that:

   • Manages authentication (API key + token)
   • Implements rate limiting (300 req/10s per key, 100 req/10s per token)
   • Provides methods for all Trello operations
   • Handles board/workspace persistence via ~/.trello-mcp/config.json