MCP サーバー Trello

Trelloボードを操作するためのツールを提供するModel Context Protocol（MCP）サーバー。このサーバーは、レート制限、型安全性、エラー処理を自動的に処理しながら、Trello APIとのシームレスな統合を実現します。

変更履歴

0.1.2

マルチステージビルドによるDockerサポートを追加
環境変数を.envに移動することでセキュリティが強化されました
Docker Compose 構成を追加しました
セットアップを簡単にするために.env.templateを追加しました

0.1.1

リスト間でカードを移動するためのmove_cardツールを追加しました
ドキュメントの改善

0.1.0

基本的なTrelloボード管理機能を備えた初期リリース

特徴

Trelloボードとの完全な統合：カード、リスト、ボードアクティビティを操作
組み込みのレート制限: Trello の API 制限 (API キーあたり 300 リクエスト/10 秒、トークンあたり 100 リクエスト/10 秒) を尊重
型安全な実装:包括的な型定義を備えたTypeScriptで記述
入力検証: すべてのAPI入力に対する堅牢な検証
エラー処理: 情報メッセージによる適切なエラー処理

インストール

Docker のインストール (推奨)

サーバーを実行する最も簡単な方法は Docker を使用することです。

リポジトリをクローンします。

git clone https://github.com/delorenj/mcp-server-trello
cd mcp-server-trello

環境テンプレートをコピーし、Trello の資格情報を入力します。

cp .env.template .env

Docker Compose でビルドして実行します。

docker compose up --build

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Trello Server を自動的にインストールするには:

npx -y @smithery/cli install @modelcontextprotocol/mcp-server-trello --client claude

手動インストール

npm install @delorenj/mcp-server-trello

構成

サーバーは環境変数を使って設定できます。ルートディレクトリに以下の変数を含む.envファイルを作成してください。

TRELLO_API_KEY=your-api-key
TRELLO_TOKEN=your-token
TRELLO_BOARD_ID=your-board-id

これらの値は以下から取得できます。

APIキー: https://trello.com/app-key
トークン: APIキーを使用して生成します
ボードID: ボードURLに記載されています

利用可能なツール

リストIDでカードを取得する

特定のリストからすべてのカードを取得します。

{
  name: 'get_cards_by_list_id',
  arguments: {
    listId: string  // ID of the Trello list
  }
}

get_lists

設定されたボードからすべてのリストを取得します。

{
  name: 'get_lists',
  arguments: {}
}

最近のアクティビティを取得する

ボード上の最近のアクティビティを取得します。

{
  name: 'get_recent_activity',
  arguments: {
    limit?: number  // Optional: Number of activities to fetch (default: 10)
  }
}

リストにカードを追加

指定されたリストに新しいカードを追加します。

{
  name: 'add_card_to_list',
  arguments: {
    listId: string,       // ID of the list to add the card to
    name: string,         // Name of the card
    description?: string, // Optional: Description of the card
    dueDate?: string,    // Optional: Due date (ISO 8601 format)
    labels?: string[]    // Optional: Array of label IDs
  }
}

カード詳細の更新

既存のカード詳細を更新します。

{
  name: 'update_card_details',
  arguments: {
    cardId: string,       // ID of the card to update
    name?: string,        // Optional: New name for the card
    description?: string, // Optional: New description
    dueDate?: string,    // Optional: New due date (ISO 8601 format)
    labels?: string[]    // Optional: New array of label IDs
  }
}

アーカイブカード

カードをアーカイブに送信します。

{
  name: 'archive_card',
  arguments: {
    cardId: string  // ID of the card to archive
  }
}

ボードにリストを追加

ボードに新しいリストを追加します。

{
  name: 'add_list_to_board',
  arguments: {
    name: string  // Name of the new list
  }
}

アーカイブリスト

リストをアーカイブに送信します。

{
  name: 'archive_list',
  arguments: {
    listId: string  // ID of the list to archive
  }
}

カードを取得する

現在のユーザーに割り当てられているすべてのカードを取得します。

{
  name: 'get_my_cards',
  arguments: {}
}

移動カード

カードを別のリストに移動します。

{
  name: 'move_card',
  arguments: {
    cardId: string,  // ID of the card to move
    listId: string   // ID of the target list
  }
}

レート制限

サーバーは、Trello の API 制限に準拠するために、レート制限用のトークンバケットアルゴリズムを実装します。

APIキーごとに10秒あたり300リクエスト
トークンごとに10秒あたり100リクエスト

レート制限は自動的に処理され、制限に達した場合、リクエストはキューに入れられます。

エラー処理

サーバーは、さまざまなシナリオに対して詳細なエラーメッセージを提供します。

無効な入力パラメータ
レート制限を超えました
API認証エラー
ネットワークの問題
無効なボード/リスト/カードID

発達

前提条件

Node.js 16以上
npmまたはyarn

設定

リポジトリをクローンする

git clone https://github.com/delorenj/mcp-server-trello
cd mcp-server-trello

依存関係をインストールする

npm install

プロジェクトを構築する

npm run build

貢献

貢献を歓迎します!

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

謝辞

モデルコンテキストプロトコルSDKで構築
Trello REST APIを使用します

MCP Server Trello

Integrations