trellio-mcp — Trello용 MCP 서버

Claude Desktop, Claude Code 및 Gemini CLI에 Trello API에 대한 전체 액세스 권한을 제공하는 MCP 서버입니다. trellio 비동기 클라이언트 라이브러리와 공식 Python MCP SDK를 기반으로 구축되었습니다. BDD 가이드라인 v1.8.0을 준수하여 개발되었습니다.

기능

• 48개의 MCP 도구 — trellio 메서드와 1:1 매핑되며, 추가로 get_board_overview 복합 도구 제공

• 2개의 리소스 템플릿 — 풍부한 컨텍스트 로딩을 위한 trello://board/{id} 및 trello://card/{id}

• 3개의 프롬프트 — 워크플로우 단축키로 사용되는 summarize_board, create_sprint, daily_standup

• 내장 인증 흐름 — python -m trello_mcp auth를 실행하면 브라우저가 열리고, 사용자가 "허용"을 클릭하면 토큰이 안전하게 저장됨

• 구조화된 오류 처리 — Trello API 오류가 명확하고 실행 가능한 MCP 오류 메시지로 변환됨

• stdio 전송 — 로컬 하위 프로세스로 실행되며 네트워크 노출 없음

Related MCP server: Trello MCP Server

도구

카드 도구는 생성 및 업데이트 시 pos (top/bottom), idLabels (쉼표로 구분), due (ISO 8601), dueComplete (true/false)를 지원합니다.

사전 요구 사항

• Python 3.10+

• Trello API 키 (http://localhost:8095를 허용된 출처에 추가)

설치

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/에 문서화됨):

테스트

이 프로젝트는 behave를 사용한 BDD를 따르며, 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가 아닌 클라이언트 경계에서 모의(mock) 수행

• 모의 호출 기록을 통한 지속성 검증 (§4.3)

• 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 일반 공중 사용 허가서 v3.0에 따라 라이선스가 부여됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.