Skip to main content
Glama

Trello MCP Server with Python

by m0xai

MCP-сервер Trello

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

Оглавление

Предпосылки

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

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

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

Установка

  1. Настройте учетные данные API Trello:
    • Перейти к администрированию приложений Trello
    • Создайте новую интеграцию в New Power-Up или Integration
    • Заполните свою информацию (URL-адрес коннектора Iframe можно оставить пустым) и убедитесь, что выбрали правильное рабочее пространство.
    • Щелкните значок вашего приложения и перейдите к пункту «Ключ API» на левой боковой панели.
    • Скопируйте свой «API-ключ» и справа: «Вы можете вручную сгенерировать токен». Нажмите на слово «токен», чтобы получить свой токен Trello.
  2. Переименуйте файл .env.example в корне проекта в .env и задайте переменные, которые вы только что получили:
TRELLO_API_KEY=your_api_key_here TRELLO_TOKEN=your_token_here
  1. Установите uv, если вы этого еще не сделали:
curl -LsSf https://astral.sh/uv/install.sh | sh
  1. Клонируйте этот репозиторий:
git clone https://github.com/m0xai/trello-mcp-server.git cd trello-mcp-server
  1. Установите зависимости и настройте сервер для Клода с помощью uv::
uv run mcp install main.py
  1. Перезапустите приложение Claude Desktop.

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

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

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

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

  1. Установите USE_CLAUDE_APP=true в вашем .env файле (это значение по умолчанию)
  2. Запустите сервер с помощью:
uv run mcp install main.py
  1. Перезапустите приложение Claude Desktop.

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

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

  1. Установите USE_CLAUDE_APP=false в вашем .env файле
  2. Запустите сервер с помощью:
python main.py
  1. По умолчанию сервер будет доступен по адресу http://localhost:8000 (или по настроенному вами порту)

Режим докера

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

  1. Убедитесь, что у вас установлены Docker и Docker Compose.
  2. Создайте файл .env с вашей конфигурацией
  3. Соберите и запустите контейнер:
docker-compose up -d
  1. По умолчанию сервер будет работать в режиме SSE.
  2. Для просмотра журналов:
docker-compose logs -f
  1. Чтобы остановить сервер:
docker-compose down

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

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

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

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

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

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

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

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

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

  1. Запустите сервер в режиме SSE ( USE_CLAUDE_APP=false )
  2. В курсоре перейдите в Настройки (значок шестеренки) > ИИ > Протокол контекста модели.
  3. Добавьте новый сервер с URL-адресом http://localhost:8000 (или настроенным вами хостом/портом)
  4. Выберите сервер при использовании функций искусственного интеллекта 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]»

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

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

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

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

Внося вклад

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

Related MCP Servers

  • -
    security
    F
    license
    -
    quality
    An MCP server that enables AI assistants like Claude to interact with Anki flashcard decks, allowing users to create, manage, and update flashcards through natural language conversations.
    Last updated -
    1
    TypeScript
  • -
    security
    F
    license
    -
    quality
    A specialized MCP server that enables AI agents to interact with Reddit, including reading posts, creating content, and managing subreddit configurations.
    Last updated -
    71
    5
    TypeScript
  • -
    security
    F
    license
    -
    quality
    A MCP server that allows AI assistants to interact with the browser, including getting page content as markdown, modifying page styles, and searching browser history.
    Last updated -
    5
    TypeScript
  • A
    security
    A
    license
    A
    quality
    An MCP server implementation that allows AI assistants to access, search, and interact with Dev.to content, including fetching articles, retrieving user information, and publishing new content.
    Last updated -
    10
    53
    Python
    MIT License
    • Apple

View all related MCP servers

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/m0xai/trello-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server