MCP Server Trello

MCP Server Trello

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

特長

• Trello ボードとの完全な連携：カード、リスト、ボードのアクティビティを操作できます
• レート制限を内蔵：Trello の API 制限（API キーあたり 10 秒間に 300 リクエスト、トークンあたり 10 秒間に 100 リクエスト）を遵守します
• 型安全な実装：包括的な型定義を備えた TypeScript で記述されています
• 入力検証：すべての API 入力を堅牢に検証します
• エラー処理：わかりやすいメッセージでエラーを適切に処理します

インストール

npm install @modelcontextprotocol/mcp-server-trello

設定

次の設定を使用して、MCP 設定ファイルにサーバーを追加します。

{
  "mcpServers": {
    "trello": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-trello"],
      "env": {
        "TRELLO_API_KEY": "your-api-key",
        "TRELLO_TOKEN": "your-token",
        "TRELLO_BOARD_ID": "your-board-id"
      }
    }
  }
}

必須の環境変数

• TRELLO_API_KEY：Trello API キー（https://trello.com/app-key から取得）
• TRELLO_TOKEN：Trello トークン（API キーを使用して生成）
• TRELLO_BOARD_ID：操作する Trello ボードの ID（ボードの URL で確認）

利用可能なツール

get_cards_by_list_id

指定したリストのすべてのカードを取得します。

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

get_lists

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

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

get_recent_activity

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

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

add_card_to_list

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

{
  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
  }
}

update_card_details

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

{
  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
  }
}

archive_card

カードをアーカイブに移動します。

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

add_list_to_board

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

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

archive_list

リストをアーカイブに移動します。

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

get_my_cards

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

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

レート制限

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

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

レート制限は自動的に処理され、制限に達するとリクエストはキューに追加されます。

エラー処理

サーバーは、さまざまな状況に応じて詳細なエラーメッセージを提供します。

• 無効な入力パラメーター
• レート制限超過
• API 認証エラー
• ネットワークの問題
• 無効なボード、リスト、カードの ID

開発

前提条件

• Node.js 16 以降
• npm または yarn

セットアップ

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

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

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

npm install

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

npm run build

テストの実行

npm test

貢献

貢献を歓迎します。行動規範とプルリクエストの提出手順については、貢献ガイドをお読みください。

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については、LICENSE ファイルをご覧ください。

謝辞

• Model Context Protocol SDK を使用して構築されています
• Trello REST API を使用しています