hint-services/mcp-trello

本页由 AI 翻译，技术细节请以原文为准。查看原文

10 stars 5 forks 质量 74 趋势 18MIT

概览

A Model Context Protocol (MCP) server that provides tools for interacting with Trello boards. This server enables seamless integration with Trello's API while handling rate limiting, type safety, and error handling automatically. - : Interact with cards, lists, and board activities - : Respects Trello's API limits (300 requests/10s per API key, 100 requests/10s per token) - : Written in TypeScript with comprehensive type definitions - : Robust validation for all API inputs using Zod schemas - : Graceful error handling with informative messages - : These servers act as bridges, exposing APIs, databases, and code libraries to external AI hosts. By implementing an MCP server in TypeScript, developers can share data sources or computational logic in a standardized way using JSON-RPC 2.0. - : These are the consumer-facing side of MCP, communicating with servers to query data or perform actions.

README

以下为原文 README 节选，完整内容请查看原文。

MCP Trello

A Model Context Protocol (MCP) server that provides tools for interacting with Trello boards. This server enables seamless integration with Trello’s API while handling rate limiting, type safety, and error handling automatically.

Features

Full Trello Board Integration: Interact with cards, lists, and board activities
Built-in Rate Limiting: Respects Trello’s API limits (300 requests/10s per API key, 100 requests/10s per token)
Type-Safe Implementation: Written in TypeScript with comprehensive type definitions
Input Validation: Robust validation for all API inputs using Zod schemas
Error Handling: Graceful error handling with informative messages

Core Components

MCP Servers: These servers act as bridges, exposing APIs, databases, and code libraries to external AI hosts. By implementing an MCP server in TypeScript, developers can share data sources or computational logic in a standardized way using JSON-RPC 2.0.
MCP Clients: These are the consumer-facing side of MCP, communicating with servers to query data or perform actions. MCP clients use TypeScript SDKs, ensuring type-safe interactions and uniform approach to tool usage.
MCP Hosts: Systems such as Claude, Cursor, Windsurf, Cline, and other TypeScript-based platforms coordinate requests between servers and clients, ensuring seamless data flow. A single MCP server can thus be accessed by multiple AI hosts without custom integrations.

Available Tools

MCP Trello provides the following tools for interacting with Trello:

Board Management

getMyBoards: Retrieve all boards for the authenticated user (useful for finding board IDs)

Card Management

getCardsByList: Fetch all cards from a specific list
getMyCards: Fetch all cards assigned to the current user (works without board ID)
addCard: Add a new card to a specified list
updateCard: Update an existing card’s details (name, description, due dates, labels, position)
moveCard: Move a card to a different list or board
archiveCard: Send a card to the archive
changeCardMembers: Add or remove members from a card

List Management

getLists: Retrieve all lists from the configured board (requires board ID)
addList: Add a new list to the board (requires board ID)
archiveList: Send a list to the archive

Board Information

getRecentActivity: Fetch recent activity on the board (requires board ID)

Project Structure

mcp-trello/
├── src/
│   ├── index.ts          # Main entry point
│   └── trello/           # Trello API integration
│       ├── client.ts     # Trello client implementation
│       ├── rate-limiter.ts # Rate limiting functionality

在 GitHub 查看完整 README

安装

npx -y @Hint-Services/mcp-trello

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "trello": {
      "command": "npx",
      "args": ["-y", "@Hint-Services/mcp-trello"],
      "env": {
        "trelloApiKey": "your-api-key",
        "trelloToken": "your-token",
        "trelloBoardId": "your-board-id"
      }
    }
  }
}