Trello MCPサーバー

🔀 アクティブなフォーク。 これはkocakli/Trello-Desktop-MCPのメンテナンスされているフォークであり、フォークエコシステム全体からの貢献（kevinhillinger、zonca、dbz-max、maks244、jantman、ThatIanMcShane、josh-argyle）を統合しています。プルリクエストを歓迎します。各貢献者が何をもたらしたかについてはクレジットを参照してください。npmではatlassian-trello-mcpとして公開されています。

Trello用のModel Context Protocol (MCP) サーバーです。Claude Desktop、Claude Code、Gemini CLIなど、MCP互換のあらゆるクライアントで動作します。

ボード、カード、リスト、ラベル、チェックリスト、添付ファイル、メンバー、カスタムフィールド、検索をカバーする46個のツールを提供します。

クイックスタート

1. Trello API認証情報を取得する

• https://trello.com/app-key にアクセスします

• APIキーをコピーします

• 読み取り/書き込みアクセスのために「トークンを生成」をクリックします

2. インストール

最も簡単な方法は npx です。クローンもビルドも不要で、実行するだけです：

npx atlassian-trello-mcp

またはソースからインストールします：

git clone https://github.com/agrath/Trello-Desktop-MCP.git
cd Trello-Desktop-MCP
npm install
npm run build

3. MCPクライアントを設定する

設定ファイルを編集します：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "trello": {
      "command": "npx",
      "args": ["-y", "atlassian-trello-mcp"],
      "env": {
        "TRELLO_API_KEY": "your-api-key",
        "TRELLO_TOKEN": "your-token"
      }
    }
  }
}

claude mcp add trello -- npx -y atlassian-trello-mcp

環境変数 TRELLO_API_KEY と TRELLO_TOKEN を設定するか、リクエストごとに認証情報を渡します。

~/.gemini/settings.json を編集します：

{
  "mcpServers": {
    "trello": {
      "command": "npx",
      "args": ["-y", "atlassian-trello-mcp"],
      "env": {
        "TRELLO_API_KEY": "your-api-key",
        "TRELLO_TOKEN": "your-token"
      }
    }
  }
}

サーバーはstdioトランスポートを使用します。環境変数を設定して実行します：

TRELLO_API_KEY=your-key TRELLO_TOKEN=your-token npx atlassian-trello-mcp
# or, from a source clone:
TRELLO_API_KEY=your-key TRELLO_TOKEN=your-token node dist/index.js

Related MCP server: fastmcp-trello

認証情報

認証情報は以下の2つの方法で提供できます：

1. 環境変数（推奨）：TRELLO_API_KEY と TRELLO_TOKEN を設定します

2. リクエストごと：ツールパラメータとして apiKey と token を渡します（環境変数を上書きします）

利用可能なツール (46)

ボードとリスト

カード

コメントとアクティビティ

ラベル

カードのメンバー

添付ファイル

チェックリスト

チェックアイテム

検索

設定

読み取り専用モード

TRELLO_READ_ONLY=true を設定すると、すべての書き込み操作が無効になります。読み取り/クエリツールのみが利用可能になります。

{
  "env": {
    "TRELLO_API_KEY": "your-key",
    "TRELLO_TOKEN": "your-token",
    "TRELLO_READ_ONLY": "true"
  }
}

コンパクトモード

いくつかのツールは compact パラメータ（デフォルト: true）をサポートしており、レスポンスサイズを削減するために最小限のフィールドを返します。説明、ラベル、メンバー、カスタムフィールドを含む詳細情報が必要な場合は compact: false を設定してください。

コンパクトモードを持つツール: get_board_details, trello_get_board_cards, trello_get_list_cards, trello_search。

画像添付ファイルのダウンロード

get_card が呼び出され、カードに画像添付ファイルがある場合、サーバーはそれらをダウンロードし、JSONと並んでインラインMCP画像コンテンツブロックとして返します。これにより、クライアントはカードの画像を直接確認できます。ダウンロードはTrelloホストのURL (*.trello.com, trello-attachments.s3.amazonaws.com) に制限されており、SSRFやペイロード肥大化のリスクを軽減するために画像あたり5MBに制限されています。

完全に無効にするには TRELLO_DOWNLOAD_IMAGES=false (または 0/no/off) を設定します。サーバーは追加の getCardAttachments 呼び出しをスキップし、テキストのみを返します。デフォルトは有効です。

ログ

TRELLO_MCP_LOGGING=true を設定すると、Pinoを介したファイルベースのログ記録が有効になります。ログは dist/logs/app.log に書き込まれます。

開発

プロジェクト構造

src/
  index.ts              Entry point (credential injection, tool routing)
  server.ts             MCP server factory (read-only mode support)
  tools/
    boards.ts           Board tools (list, details, lists, filter)
    cards.ts            Card tools (CRUD, archive)
    lists.ts            List tools (cards, create list, comments)
    members.ts          Member tools (user boards, member details)
    search.ts           Search tool
    advanced.ts         Labels, attachments, members on cards, custom fields
    checklists.ts       Checklist and check item tools (13 tools)
  trello/
    client.ts           TrelloClient (API calls, retry, rate limiting)
  types/
    trello.ts           TypeScript interfaces
  utils/
    validation.ts       Zod schemas, extractCredentials, extractTrelloId
    logger.ts           Pino file logger
    health.ts           Health check utility
    appInsights.ts      Telemetry (no-op)
tests/
  validation.test.ts    Validation and credential extraction tests
  trelloClient.test.ts  API client tests (mocked fetch)
  tools.test.ts         Tool handler tests (mocked client)

ビルドとテスト

npm install
npm run build
npm test
npm run type-check

主要なパターン

• ID解決: すべてのツールは extractTrelloId() を介してTrello URL、短いID、または24文字の完全な16進数IDを受け入れます

• 認証情報のフォールバック: extractCredentials() は最初に引数をチェックし、次に環境変数をチェックします

• バックオフ付きリトライ: TrelloClientは500エラー/ネットワークエラー時にリトライします（3回試行、指数バックオフ）

• レート制限: すべてのレスポンスから x-rate-limit-* ヘッダーを抽出して返します

• バリデーション: ZodスキーマがAPI呼び出しの前にすべての入力を検証します

貢献

プルリクエストを歓迎し、積極的にレビューしています。このフォークは熱心なTrelloユーザーによってメンテナンスされているため、機能は実環境でテストされています。

元のプロジェクトをフォークして便利なものを作成した場合は、別のフォークを維持するのではなく、ここにプルリクエストを送信してください。単一の十分にメンテナンスされたプロジェクトから全員が恩恵を受ける方が簡単です。

貢献するには:

1. このリポジトリをフォークする

2. フィーチャーブランチを作成する

3. 新機能のテストを追加する

4. npm test と npm run build を実行する

5. 何を、なぜ変更したかを明確に説明したプルリクエストを送信する

クレジット

このプロジェクトは kocakli/Trello-Desktop-MCP のフォークです。機能やアイデアはフォークエコシステム全体から取り入れられました:

• kocakli -- オリジナルプロジェクト、MCPクライアント非依存のブランド変更、stderrログ修正

• kevinhillinger -- 認証情報注入アーキテクチャ、ラベル削除、カードメンバー管理、カードアーカイブ、TypeScript型の拡張、リソースレイヤー

• zonca -- 環境変数フォールバック付きの集中認証情報処理、ラベル管理ツール、包括的なユニットテスト、any を置き換える改善されたTypeScript型

• dbz-max -- カスタムフィールドのサポート（ボードカスタムフィールド + カードカスタムフィールドアイテム）

• maks244 -- 読み取り専用モードのコンセプト、名前によるリストフィルタリング、テレメトリログからの認証情報削除

• jantman -- MCPクライアントによって文字列として送信された際に拒否される数値の pos 値の修正

• ThatIanMcShane -- 現在のClaude Codeリリースでの接続タイムアウトを修正するために @modelcontextprotocol/sdk を 1.0.4 から 1.29.0 に更新

• josh-argyle -- get_card レスポンス内の画像添付ファイルをインラインMCP画像コンテンツブロックとして自動ダウンロード（移植中に許可リストとサイズ制限を追加）

ライセンス

MIT