MCP-сервер Trello

Name: Trello MCP Server with Python
Author: m0xai

Мощный MCP-сервер для взаимодействия с досками, списками и карточками Trello через хосты ИИ.

Предпосылки

Python 3.12 или выше, может легко управляться с помощью uv
Установлен Claude for Desktop
Учетная запись Trello и учетные данные API
установлен менеджер пакетов uv

Предварительная установка

Убедитесь, что у вас установлено приложение Claude Desktop.
Убедитесь, что вы уже вошли в свою учетную запись в Claude.
Старт Клод

Установка

Настройте учетные данные API Trello:
- Перейти к администрированию приложений Trello
- Создайте новую интеграцию в New Power-Up или Integration
- Заполните свою информацию (URL-адрес коннектора Iframe можно оставить пустым) и убедитесь, что выбрали правильное рабочее пространство.
- Щелкните значок вашего приложения и перейдите к пункту «Ключ API» на левой боковой панели.
- Скопируйте свой «API-ключ» и справа: «Вы можете вручную сгенерировать токен». Нажмите на слово «токен», чтобы получить свой токен Trello.
Переименуйте файл .env.example в корне проекта в .env и задайте переменные, которые вы только что получили:

TRELLO_API_KEY=your_api_key_here TRELLO_TOKEN=your_token_here

Установите uv, если вы этого еще не сделали:

curl -LsSf https://astral.sh/uv/install.sh | sh

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

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

Установите зависимости и настройте сервер для Клода с помощью uv::

uv run mcp install main.py

Перезапустите приложение Claude Desktop.

Режимы сервера

Этот сервер MCP может работать в двух различных режимах:

Режим приложения Клода

Этот режим напрямую интегрируется с приложением Claude Desktop:

Установите USE_CLAUDE_APP=true в вашем .env файле (это значение по умолчанию)
Запустите сервер с помощью:

uv run mcp install main.py

Перезапустите приложение Claude Desktop.

Режим сервера SSE

Этот режим работает как автономный сервер SSE, который можно использовать с любым MCP-совместимым клиентом, включая Cursor:

Установите USE_CLAUDE_APP=false в вашем .env файле
Запустите сервер с помощью:

python main.py

По умолчанию сервер будет доступен по адресу http://localhost:8000 (или по настроенному вами порту)

Режим докера

Вы также можете запустить сервер с помощью Docker Compose:

Убедитесь, что у вас установлены Docker и Docker Compose.
Создайте файл .env с вашей конфигурацией
Соберите и запустите контейнер:

docker-compose up -d

По умолчанию сервер будет работать в режиме SSE.
Для просмотра журналов:

docker-compose logs -f

Чтобы остановить сервер:

docker-compose down

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

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

Переменная	Описание	По умолчанию
TRELLO_API_KEY	Ваш ключ API Trello	Необходимый
TRELLO_TOKEN	Ваш токен API Trello	Необходимый
MCP_SERVER_NAME	Имя MCP-сервера	MCP-сервер Trello
MCP_СЕРВЕР_ХОСТ	Адрес хоста для режима SSE	0.0.0.0
MCP_SERVER_PORT	Порт для режима SSE	8000
ИСПОЛЬЗОВАТЬ_CLAUDE_APP	Использовать ли режим приложения Claude	истинный

Вы можете настроить сервер, отредактировав эти значения в файле .env .

Интеграция клиента

Использование с Claude Desktop

Запустите сервер в режиме приложения Claude ( USE_CLAUDE_APP=true )
Запустить или перезапустить Claude Desktop
Клод автоматически обнаружит ваш сервер MCP и подключится к нему.

Использование с курсором

Чтобы подключить ваш MCP-сервер к Cursor:

Запустите сервер в режиме SSE ( USE_CLAUDE_APP=false )
В курсоре перейдите в Настройки (значок шестеренки) > ИИ > Протокол контекста модели.
Добавьте новый сервер с URL-адресом http://localhost:8000 (или настроенным вами хостом/портом)
Выберите сервер при использовании функций искусственного интеллекта Cursor

Вы также можете добавить эту конфигурацию в файл JSON настроек курсора (обычно в ~/.cursor/mcp.json ):

{ "mcpServers": { "trello": { "url": "http://localhost:8000/sse" } } }

Использование с другими клиентами MCP

Для других MCP-совместимых клиентов укажите конечную точку SSE по адресу http://localhost:8000 .

Пример минимального клиента

Вот минимальный пример Python для подключения к конечной точке SSE:

import asyncio import httpx async def connect_to_mcp_server(): url = "http://localhost:8000/sse" headers = {"Accept": "text/event-stream"} async with httpx.AsyncClient() as client: async with client.stream("GET", url, headers=headers) as response: # Get the session ID from the first SSE message session_id = None async for line in response.aiter_lines(): if line.startswith("data:"): data = line[5:].strip() if "session_id=" in data and not session_id: session_id = data.split("session_id=")[1] # Send a message using the session ID message_url = f"http://localhost:8000/messages/?session_id={session_id}" message = { "role": "user", "content": { "type": "text", "text": "Show me my Trello boards" } } await client.post(message_url, json=message) if __name__ == "__main__": asyncio.run(connect_to_mcp_server())

Возможности

Операция	Доска	Список	Карточка	Контрольный список	Пункт контрольного списка
Читать	✅	✅	✅	✅	✅
Писать	❌	✅	✅	✅	✅
Обновлять	❌	✅	✅	✅	✅
Удалить	❌	✅	✅	✅	✅

Подробные возможности

Операции совета директоров

✅ Читать все доски
✅ Ознакомьтесь с подробностями конкретной доски

Список операций

✅ Прочитать все списки на доске
✅ Прочитайте конкретные детали списка
✅ Создавайте новые списки
✅ Обновить название списка
✅ Архивировать (удалять) списки

Операции с картами

✅ Прочитать все карты в списке
✅ Прочитайте данные конкретной карты
✅ Создавайте новые карты
✅ Обновить атрибуты карты
✅ Удалить карты

Контрольный список операций

✅ Получите конкретный контрольный список
✅ Перечислите все контрольные списки на карточке
✅ Создайте новый контрольный список
✅ Обновите контрольный список
✅ Удалить контрольный список
✅ Добавить контрольный пункт в контрольный список
✅ Обновить контрольный элемент
✅ Удалить контрольный элемент

Использование

После установки вы сможете взаимодействовать с досками Trello через Claude. Вот несколько примеров запросов:

«Покажи мне все мои доски»
«Какие списки есть на доске [имя_доски]?»
«Создать новую карточку в списке [list_name] с заголовком [title]»
«Обновить описание карты [имя_карты]»
«Архивировать список [list_name]»

Вот мои примеры использования:

Поиск неисправностей

Если у вас возникли проблемы:

Проверьте свои учетные данные API Trello в файле .env
Проверьте, есть ли у вас необходимые разрешения в вашем рабочем пространстве Trello.
Убедитесь, что у вас установлена последняя версия Claude for Desktop
Проверьте журналы на наличие сообщений об ошибках с помощью команды uv run mcp dev main.py
Убедитесь, что uv правильно установлен и находится в вашем PATH.

Внося вклад

Не стесняйтесь отправлять сообщения о проблемах и запросы на улучшения!

One-click Deploy

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Tools

View all tools

Trello MCP Server with Python