Trello Mcp

Trello MCP

Model Context Protocol (MCP) サーバーです。Claude Desktop、Claude Code、Gemini CLI など、MCP 互換のあらゆるクライアントに包括的な Trello 連携を提供します。このサーバーにより、AI アシスタントは安全なローカル接続を通じて Trello のボード、カード、リストなどとやり取りできます。

機能

🔍 検索と探索

• ユニバーサル検索: すべての Trello コンテンツ (ボード、カード、メンバー、組織) を横断して検索
• ユーザーボード: 現在のユーザーがアクセスできるすべてのボードを取得
• ボードの詳細: リストやカードを含むボードの詳細情報を取得

📝 カード管理

• カードの作成: 説明、期限、担当者を指定して任意のリストに新しいカードを追加
• カードの更新: 名前、説明、期限、ステータスなどのカードプロパティを変更
• カードの移動: ワークフローのステータスを更新するためにカードをリスト間で移動
• カードの詳細取得: メンバー、ラベル、チェックリストを含む包括的なカード情報を取得

💬 コラボレーション

• コメントの追加: チームコミュニケーションのためにカードにコメントを投稿
• メンバー管理: ボードのメンバーとメンバーの詳細を表示
• アクティビティ履歴: カードのアクションと変更を追跡

📋 整理

• リスト管理: 新しいリストを作成し、特定のリスト内のカードを取得
• ラベル: 分類のためにボードのラベルを表示および管理
• チェックリスト: カードのチェックリストとチェックリスト項目にアクセス
• 添付ファイル: カードの添付ファイルとリンクされたファイルを表示

インストール

前提条件

• Node.js 18+ がインストールされていること
• MCP 互換のクライアント (Claude Desktop、Claude Code、Gemini CLI など)
• API 認証情報を持つ Trello アカウント

セットアップ手順

1. リポジトリをクローン

   git clone https://github.com/kocakli/trello-desktop-mcp.git
   cd trello-desktop-mcp
   

2. 依存関係をインストール

   npm install
   

3. プロジェクトをビルド

   npm run build
   

4. Trello API 認証情報を取得

   • https://trello.com/app-key にアクセスします
   • API Key をコピーします
   • Token を生成します (無期限、読み取り/書き込みアクセス)

5. MCP クライアントを設定

   以下からお使いのクライアントの手順を選択してください:

   Claude Desktop

   Claude Desktop の設定ファイルを編集します:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

   Trello MCP サーバーを追加します:

   {
     "mcpServers": {
       "trello": {
         "command": "node",
         "args": ["/absolute/path/to/trello-desktop-mcp/dist/index.js"],
         "env": {
           "TRELLO_API_KEY": "your-api-key-here",
           "TRELLO_TOKEN": "your-token-here"
         }
       }
     }
   }
   

   その後、Claude Desktop を再起動します。

   Claude Code (CLI)

   Claude Code CLI を使用してサーバーを追加します:

   claude mcp add trello -- node /absolute/path/to/trello-desktop-mcp/dist/index.js \
     -e TRELLO_API_KEY=your-api-key-here \
     -e TRELLO_TOKEN=your-token-here
   

   または、プロジェクトの .mcp.json に追加します:

   {
     "mcpServers": {
       "trello": {
         "command": "node",
         "args": ["/absolute/path/to/trello-desktop-mcp/dist/index.js"],
         "env": {
           "TRELLO_API_KEY": "your-api-key-here",
           "TRELLO_TOKEN": "your-token-here"
         }
       }
     }
   }
   

   Gemini CLI

   ~/.gemini/settings.json にある Gemini CLI の設定ファイルを編集します:

   {
     "mcpServers": {
       "trello": {
         "command": "node",
         "args": ["/absolute/path/to/trello-desktop-mcp/dist/index.js"],
         "env": {
           "TRELLO_API_KEY": "your-api-key-here",
           "TRELLO_TOKEN": "your-token-here"
         }
       }
     }
   }
   

   その他の MCP クライアント

   stdio トランスポートをサポートする MCP 互換のクライアントであれば、このサーバーを使用できます。次のように設定する必要があります:

   1. node /absolute/path/to/trello-desktop-mcp/dist/index.js を実行する
   2. 環境変数 TRELLO_API_KEY と TRELLO_TOKEN を設定する

   正確な設定形式については、お使いのクライアントのドキュメントを参照してください。

6. MCP クライアントを再起動して、新しい設定を反映します。

利用可能なツール

MCP サーバーは、3 つのフェーズに整理された 19 個のツールを提供します:

フェーズ 1: 必須ツール

• trello_search - すべての Trello コンテンツを横断するユニバーサル検索
• trello_get_user_boards - 現在のユーザーがアクセスできるすべてのボードを取得
• get_board_details - リストとカードを含む詳細なボード情報を取得
• get_card - 包括的なカードの詳細を取得
• create_card - 任意のリストに新しいカードを作成

フェーズ 2: コア操作

• update_card - カードプロパティを更新
• move_card - カードをリスト間で移動
• trello_add_comment - カードにコメントを追加
• trello_get_list_cards - 特定のリスト内のすべてのカードを取得
• trello_create_list - ボードに新しいリストを作成

フェーズ 3: 高度な機能

• trello_get_board_cards - フィルタリングを使用してボードからすべてのカードを取得します
• trello_get_card_actions - カードのアクティビティ履歴を取得します
• trello_get_card_attachments - カードの添付ファイルを取得します
• trello_get_card_checklists - カードのチェックリストを取得します
• trello_get_board_members - ボードのメンバーを取得します
• trello_get_board_labels - ボードのラベルを取得します
• trello_get_member - メンバーの詳細を取得します

レガシーツール (後方互換性)

• list_boards - ユーザーのボードを一覧表示します
• get_lists - ボード内のリストを取得します

使用例

設定が完了すると、AI アシスタントとの自然言語を使用して Trello を操作できます:

"Show me all my Trello boards"
"Create a new card called 'Update documentation' in the To Do list"
"Move card X from In Progress to Done"
"Add a comment to card Y saying 'This is ready for review'"
"Search for all cards with 'bug' in the title"
"Show me all cards assigned to me"

アーキテクチャ

MCP プロトコル

このサーバーは Model Context Protocol (MCP) を実装しており、以下を提供します:

• 標準化されたツールの検出と呼び出し
• 型安全なパラメータの検証
• 構造化されたエラー処理
• 自動的な認証情報の管理

セキュリティ

• API 認証情報は MCP クライアントの設定にローカルに保存されます
• 認証情報はネットワーク経由で送信されません
• すべての Trello API 呼び出しは HTTPS を使用します
• 自動再試行ロジックによりレート制限が遵守されます

技術スタック

• 型安全性のための TypeScript
• プロトコル実装のための MCP SDK
• スキーマ検証のための Zod
• HTTP リクエストのための Fetch API

開発

プロジェクト構造

├── src/
│   ├── index.ts          # Main MCP server entry point
│   ├── server.ts         # Alternative server implementation
│   ├── tools/            # Tool implementations
│   │   ├── boards.ts     # Board-related tools
│   │   ├── cards.ts      # Card-related tools
│   │   ├── lists.ts      # List-related tools
│   │   ├── members.ts    # Member-related tools
│   │   ├── search.ts     # Search functionality
│   │   └── advanced.ts   # Advanced features
│   ├── trello/           # Trello API client
│   │   └── client.ts     # API client with retry logic
│   ├── types/            # TypeScript type definitions
│   └── utils/            # Utility functions
├── dist/                 # Compiled JavaScript
└── package.json          # Project configuration

ソースからのビルド

# Install dependencies
npm install

# Build the project
npm run build

# Run type checking
npm run type-check

テスト

このサーバーには包括的なエラー処理と検証が含まれています。以下を実行してセットアップをテストしてください:

1. MCP クライアントの接続ステータスを確認する
2. 「Show me my Trello boards」のような簡単なコマンドを実行する
3. レスポンスにボードのデータが含まれていることを確認する

トラブルシューティング

よくある問題

1. 「利用可能な Trello ツールがありません」

   • 設定後に MCP クライアントが完全に再起動されていることを確認してください
   • 設定内のパスが dist/index.js を指していることを確認してください
   • ファイルが存在し、ビルドされていることを確認してください

2. 「無効な認証情報」

   • API キーとトークンを再確認してください
   • トークンに読み取り/書き込み権限があることを確認してください
   • 必要に応じてトークンを再生成してください

3. 「レート制限を超過しました」

   • このサーバーには自動再試行ロジックが含まれています
   • 制限に達した場合は数分待ってください
   • リクエスト頻度を減らすことを検討してください

デバッグログ

接続とエラーの詳細については、MCP クライアントのログを確認してください。Claude Desktop の場合、ログは以下にあります:

• macOS: ~/Library/Logs/Claude/mcp-server-trello.log
• Windows: %APPDATA%\Claude\Logs\mcp-server-trello.log

コントリビューション

コントリビューションを歓迎します! 以下をお願いします:

1. リポジトリをフォークする
2. フィーチャーブランチを作成する
3. 新機能のテストを追加する
4. プルリクエストを送信する

ライセンス

MIT License - 詳細は LICENSE ファイルを参照してください

謝辞

• Model Context Protocol SDK を使用して構築されています
• Trello REST API を使用しています
• Claude Desktop、Claude Code、Gemini CLI、その他の MCP クライアントと互換性があります