trellio-mcp — MCP-сервер для Trello

MCP-сервер, который предоставляет Claude Desktop, Claude Code и Gemini CLI полный доступ к API Trello. Построен на базе асинхронной клиентской библиотеки trellio и официального Python MCP SDK. Разработан в соответствии с рекомендациями BDD v1.8.0.

Функции

• 48 инструментов MCP — прямое соответствие методам trellio, плюс один составной инструмент get_board_overview

• 2 шаблона ресурсов — trello://board/{id} и trello://card/{id} для загрузки расширенного контекста

• 3 промпта — summarize_board, create_sprint, daily_standup в качестве ярлыков рабочих процессов

• Встроенный процесс аутентификации — python -m trello_mcp auth открывает браузер, пользователь нажимает «Разрешить», токен сохраняется безопасно

• Структурированная обработка ошибок — ошибки API Trello преобразуются в понятные и полезные сообщения об ошибках MCP

• Транспорт stdio — работает как локальный подпроцесс, без сетевой поверхности атаки

Related MCP server: Trello MCP Server

Инструменты

Инструменты для карточек поддерживают pos (top/bottom), idLabels (через запятую), due (ISO 8601) и dueComplete (true/false) при создании и обновлении.

Предварительные требования

• Python 3.10+

• Ключ API Trello (добавьте http://localhost:8095 в Allowed Origins)

Установка

Smithery

npx @smithery/cli install gupta/trellio-mcp --client claude

Использование pipx (рекомендуется)

Для глобальной установки, чтобы команда trellio-mcp была доступна в вашем PATH:

pipx install trellio-mcp

Альтернативно, вы можете запустить его «на лету» без установки:

pipx run trellio-mcp

(Примечание: Если вы используете pipx run, конфигурация вашего MCP-клиента также должна использовать pipx в качестве команды и run trellio-mcp в качестве аргументов.)

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

pip install trellio-mcp

Из исходного кода

git clone https://github.com/scaratec/trellio-mcp.git
cd trellio-mcp
python3 -m venv .venv
.venv/bin/pip install -e ".[dev]"

Аутентификация

Интерактивная (рекомендуется)

Запустите команду аутентификации на каждой машине, чтобы подключить свою учетную запись Trello:

Если вы установили глобально (pipx install или pip install):

TRELLO_API_KEY=your_api_key trellio-mcp auth

Если используете выполнение «на лету» (pipx run):

TRELLO_API_KEY=your_api_key pipx run trellio-mcp auth

Это откроет браузер, где вы авторизуете приложение. Токен захватывается автоматически и сохраняется в ~/.config/trellio-mcp/credentials.json (права доступа 0600).

После аутентификации переменные окружения не требуются — сервер считывает сохраненные учетные данные при запуске.

Переменные окружения (резервный вариант)

Если сохраненные учетные данные не найдены, сервер переключается на переменные окружения:

export TRELLO_API_KEY=your_api_key
export TRELLO_TOKEN=your_token

Конфигурация MCP-клиента

Claude Desktop

Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "trello": {
      "command": "pipx",
      "args": ["run", "trellio-mcp"]
    }
  }
}

Если используете аутентификацию через переменные окружения вместо сохраненных учетных данных, добавьте:

"env": {
  "TRELLO_API_KEY": "your_api_key",
  "TRELLO_TOKEN": "your_token"
}

Claude Code

Добавьте в ~/.claude/settings.json или в проект .claude/settings.json:

{
  "mcpServers": {
    "trello": {
      "command": "pipx",
      "args": ["run", "trellio-mcp"]
    }
  }
}

Gemini CLI

Добавьте в ~/.gemini/settings.json:

{
  "mcpServers": {
    "trello": {
      "command": "pipx",
      "args": ["run", "trellio-mcp"]
    }
  }
}

Архитектура

MCP Client (Claude / Gemini)
    │ stdio (JSON-RPC)
    ▼
trellio-mcp (FastMCP)
    │ async/await
    ▼
trellio (httpx)
    │ HTTPS
    ▼
Trello API

Ключевые решения (задокументированы в docs/adr/):

Тестирование

Проект использует BDD с behave, в соответствии с рекомендациями BDD v1.8.0.

PYTHONPATH=src .venv/bin/python -m behave

17 features passed, 0 failed, 0 skipped
163 scenarios passed, 0 failed, 0 skipped
970 steps passed, 0 failed, 0 skipped

Архитектура тестирования:

• AsyncMock(spec=TrellioClient) — мок на границе клиента, а не HTTP

• Проверка персистентности через записи вызовов моков (§4.3)

• Защита от хардкода через Scenario Outlines с >= 2 вариантами (§2.3)

• Послойное перечисление путей сбоев (§4.5)

• Независимый аудит спецификаций согласно §13

См. Тематическое исследование для подробного описания процесса разработки на основе BDD.

Структура проекта

trellio-mcp/
├── src/trello_mcp/
│   ├── __init__.py        # Tool registration
│   ├── __main__.py        # Entry point (server + auth)
│   ├── server.py          # FastMCP instance + client mgmt
│   ├── auth.py            # OAuth flow + credential storage
│   ├── errors.py          # Error translation (ADR 007)
│   ├── tools/             # 10 modules, 48 tools
│   ├── resources.py       # 2 resource templates
│   └── prompts.py         # 3 prompts
├── features/              # 17 BDD feature files
│   └── steps/             # Step definitions
├── docs/
│   ├── adr/               # 7 Architecture Decision Records
│   ├── tool-design.md     # Scenario-driven tool analysis
│   └── case-study-bdd-mcp-server.md
└── pyproject.toml

Публикация

PyPI

uv build
twine upload dist/trellio_mcp-<version>*

Smithery

Пространство имен — gupta. Обновите релиз после новой версии PyPI:

npx @smithery/cli mcp publish "https://github.com/scaratec/trellio-mcp" -n gupta/trellio-mcp

Также обновите закрепленную версию в smithery.yaml commandFunction.

Лицензия

Этот проект лицензирован по лицензии GNU General Public License v3.0 — подробности см. в файле LICENSE.