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を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ガイドライン v1.8.0に従い、behaveを使用したBDDを採用しています。

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)

• 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ファイルを参照してください。