Сервер Trello MCP с Python

MCP-сервер Trello

Мощный 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.

Внося вклад

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

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.