MCP-сервер Trello

Integrations

Provides tools for interacting with Trello boards, including fetching cards and lists, adding new cards and lists, updating card details, archiving cards and lists, and fetching recent activity.

MCP-сервер Trello

Сервер Model Context Protocol (MCP), предоставляющий инструменты для взаимодействия с досками Trello. Этот сервер обеспечивает бесшовную интеграцию с API Trello, одновременно автоматически обрабатывая ограничение скорости, безопасность типов и обработку ошибок.

Журнал изменений

0.3.0

Добавлены возможности управления доской и рабочим пространством:
- list_boards — список всех досок, к которым у пользователя есть доступ
- set_active_board — Установить активную доску для будущих операций
- list_workspaces — список всех рабочих пространств, к которым у пользователя есть доступ
- set_active_workspace — Установить активное рабочее пространство для будущих операций
- list_boards_in_workspace — список всех досок в определенном рабочем пространстве
- get_active_board_info — Получить информацию о текущей активной доске
Добавлено постоянное хранилище конфигурации для запоминания активной доски/рабочего пространства.
Улучшена обработка ошибок для всех новых операций.

0.2.1

Добавлены подробные комментарии JSDoc к функциям ограничителя скорости
Улучшена обработка ошибок при прикреплении изображений.
Обновлена документация для инструмента attach_image_to_card

0.2.0

Добавлен инструмент attach_image_to_card для прикрепления изображений к карточкам с URL-адресов.
Добавлена поддержка Docker с многоэтапной сборкой
Улучшена безопасность за счет перемещения переменных среды в .env
Добавлена конфигурация Docker Compose
Добавлен .env.template для более простой настройки

0.1.1

Добавлен инструмент move_card для перемещения карточек между списками.
Улучшенная документация

0.1.0

Первоначальный выпуск с базовыми функциями управления досками Trello

Функции

Полная интеграция с доской Trello : взаимодействие с карточками, списками и действиями на доске
Встроенное ограничение скорости : соблюдает ограничения API Trello (300 запросов/10 с на ключ API, 100 запросов/10 с на токен)
Типобезопасная реализация : написана на TypeScript с подробными определениями типов.
Проверка входных данных : надежная проверка всех входных данных API
Обработка ошибок : Грамотная обработка ошибок с информативными сообщениями.
Динамический выбор доски : переключение между досками и рабочими пространствами без перезапуска

Установка

Установка Docker (рекомендуется)

Самый простой способ запустить сервер — использовать Docker:

Клонируйте репозиторий:

git clone https://github.com/delorenj/mcp-server-trello
cd mcp-server-trello

Скопируйте шаблон среды и заполните свои учетные данные Trello:

cp .env.template .env

Сборка и запуск с помощью Docker Compose:

docker compose up --build

Установка через Smithery

Чтобы автоматически установить Trello Server для Claude Desktop через Smithery :

npx -y @smithery/cli install @modelcontextprotocol/mcp-server-trello --client claude

Ручная установка

npm install @delorenj/mcp-server-trello

Конфигурация

Переменные среды

Сервер можно настроить с помощью переменных окружения. Создайте файл .env в корневом каталоге со следующими переменными:

# Required: Your Trello API credentials
TRELLO_API_KEY=your-api-key
TRELLO_TOKEN=your-token

# Required: Initial board ID (can be changed later using set_active_board)
TRELLO_BOARD_ID=your-board-id

# Optional: Initial workspace ID (can be changed later using set_active_workspace)
TRELLO_WORKSPACE_ID=your-workspace-id

Эти значения можно получить из:

API-ключ: https://trello.com/app-key
Токен: сгенерируйте, используя свой ключ API
ID доски: указан в URL-адресе доски (например, https://trello.com/b/BOARD\_ID/имя-доски )
Идентификатор рабочего пространства: находится в настройках рабочего пространства или с помощью инструмента list_workspaces

Управление советом директоров и рабочим пространством

Начиная с версии 0.3.0 сервер MCP поддерживает динамический выбор доски и рабочего пространства:

TRELLO_BOARD_ID в вашем файле .env используется как начальный идентификатор доски при запуске сервера.
Вы можете изменить активную доску в любое время с помощью инструмента set_active_board
Выбранная доска сохраняется между перезапусками сервера (хранится в ~/.trello-mcp/config.json )
Аналогично вы можете установить и сохранить активное рабочее пространство с помощью set_active_workspace

Это позволяет работать с несколькими досками и рабочими пространствами без перезапуска сервера или изменения переменных среды.

Пример рабочего процесса

Начните с перечисления доступных плат:

{
  name: 'list_boards',
  arguments: {}
}

Установите активную доску:

{
  name: 'set_active_board',
  arguments: {
    boardId: "abc123"  // ID from list_boards response
  }
}

При необходимости перечислите рабочие пространства:

{
  name: 'list_workspaces',
  arguments: {}
}

При необходимости установите активное рабочее пространство:

{
  name: 'set_active_workspace',
  arguments: {
    workspaceId: "xyz789"  // ID from list_workspaces response
  }
}

Проверьте информацию о текущей активной доске:

{
  name: 'get_active_board_info',
  arguments: {}
}

Доступные инструменты

получить_карты_по_идентификатору_списка

Извлечь все карты из определенного списка.

{
  name: 'get_cards_by_list_id',
  arguments: {
    listId: string  // ID of the Trello list
  }
}

получить_списки

Получить все списки с активной в данный момент доски.

{
  name: 'get_lists',
  arguments: {}
}

получить_недавнюю_активность

Получить последние действия на активной в данный момент доске.

{
  name: 'get_recent_activity',
  arguments: {
    limit?: number  // Optional: Number of activities to fetch (default: 10)
  }
}

добавить_карту_в_список

Добавить новую карту в указанный список.

{
  name: 'add_card_to_list',
  arguments: {
    listId: string,       // ID of the list to add the card to
    name: string,         // Name of the card
    description?: string, // Optional: Description of the card
    dueDate?: string,    // Optional: Due date (ISO 8601 format)
    labels?: string[]    // Optional: Array of label IDs
  }
}

обновить_карту_детали

Обновите данные существующей карты.

{
  name: 'update_card_details',
  arguments: {
    cardId: string,       // ID of the card to update
    name?: string,        // Optional: New name for the card
    description?: string, // Optional: New description
    dueDate?: string,    // Optional: New due date (ISO 8601 format)
    labels?: string[]    // Optional: New array of label IDs
  }
}

архивная_карточка

Отправить открытку в архив.

{
  name: 'archive_card',
  arguments: {
    cardId: string  // ID of the card to archive
  }
}

добавить_список_на_доску

Добавить новый список на текущую активную доску.

{
  name: 'add_list_to_board',
  arguments: {
    name: string  // Name of the new list
  }
}

архив_список

Отправить список в архив.

{
  name: 'archive_list',
  arguments: {
    listId: string  // ID of the list to archive
  }
}

получить_мои_карты

Получить все карты, назначенные текущему пользователю.

{
  name: 'get_my_cards',
  arguments: {}
}

переместить_карту

Переместить карточку в другой список.

{
  name: 'move_card',
  arguments: {
    cardId: string,  // ID of the card to move
    listId: string   // ID of the target list
  }
}

прикрепить_изображение_к_карточке

Прикрепите изображение к карточке непосредственно из URL-адреса.

{
  name: 'attach_image_to_card',
  arguments: {
    cardId: string,  // ID of the card to attach the image to
    imageUrl: string, // URL of the image to attach
    name?: string    // Optional: Name for the attachment (defaults to "Image Attachment")
  }
}

список_досок

Список всех досок, к которым у пользователя есть доступ.

{
  name: 'list_boards',
  arguments: {}
}

установить_активную_доску

Установите активную доску для будущих операций.

{
  name: 'set_active_board',
  arguments: {
    boardId: string  // ID of the board to set as active
  }
}

список_рабочих_пространств

Перечислите все рабочие пространства, к которым у пользователя есть доступ.

{
  name: 'list_workspaces',
  arguments: {}
}

установить_активное_рабочее пространство

Установите активное рабочее пространство для будущих операций.

{
  name: 'set_active_workspace',
  arguments: {
    workspaceId: string  // ID of the workspace to set as active
  }
}

список_досок_в_рабочем_пространстве

Перечислите все доски в определенном рабочем пространстве.

{
  name: 'list_boards_in_workspace',
  arguments: {
    workspaceId: string  // ID of the workspace to list boards from
  }
}

получить_активную_информацию_доски

Получите информацию о текущей активной доске.

{
  name: 'get_active_board_info',
  arguments: {}
}

Ограничение скорости

Сервер реализует алгоритм токен-корзины для ограничения скорости в соответствии с ограничениями API Trello:

300 запросов за 10 секунд на один ключ API
100 запросов за 10 секунд на токен

Ограничение скорости обрабатывается автоматически, и запросы будут поставлены в очередь при достижении лимитов.

Обработка ошибок

Сервер предоставляет подробные сообщения об ошибках для различных сценариев:

Неверные входные параметры
Превышен лимит скорости
Ошибки аутентификации API
Проблемы с сетью
Недействительные идентификаторы доски/списка/карты

Разработка

Предпосылки

Node.js 16 или выше
npm или пряжа

Настраивать

Клонировать репозиторий

git clone https://github.com/delorenj/mcp-server-trello
cd mcp-server-trello

Установить зависимости

npm install

Построить проект

npm run build

Внося вклад

Ваши вклады приветствуются!

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE .

Благодарности

Создано с помощью SDK Model Context Protocol
Использует API REST Trello

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

Облегчает взаимодействие с досками Trello через API Trello, предлагая такие функции, как ограничение скорости, безопасность типов, проверка ввода и обработка ошибок для бесперебойного управления карточками, списками и действиями на доске.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Trello MCP Server
andypost
A
security
F
license
A
quality
Enables interaction with Trello boards, lists, and cards through Model Context Protocol (MCP) tools, leveraging TypeScript for type safety and asynchronous operations.
Last updated -
5
JavaScript
Claude MCP Trello
hrs-asano
A
security
A
license
A
quality
A Model Context Protocol server that provides tools for interacting with Trello boards, enabling seamless management of cards, lists, and activities while handling rate limiting and type safety.
Last updated -
10
3
JavaScript
MIT License
trello-mcp-server
v4lheru
-
security
A
license
-
quality
Connects to Trello with all the tools available that I was able to find in API reference
Last updated -
3
1
TypeScript
MIT License
MTG Deck Manager MCP Servers
artillect
-
security
F
license
-
quality
Enables Magic: The Gathering players to manage decks and access card information through Claude, supporting gameplay actions like drawing cards and mulligans while providing Scryfall API integration for card lookups.
Last updated -
Python

View all related MCP servers