Diegofornalha MCP Server Trello

🚀 MCP サーバ Trello

このサーバは、モデルコンテキストプロトコル（MCP）を用いたTrelloボードとのやり取りを可能にするツールです。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から取得）

利用可能なツール

💻 使用例

基本的な使用法

// リストIDに基づいてすべてのカードを取得する
{
  name: 'get_cards_by_list_id',
  arguments: {
    listId: string  // リストID
  }
}

// 設定されたボード内のすべてのリストを取得する
{
  name: 'get_lists',
  arguments: {}
}

// ボード上の最近のアクティビティを取得する
{
  name: 'get_recent_activity',
  arguments: {
    limit?: number  // オプション：取得するアクティビティの数（デフォルト：10）
  }
}

// 新しいカードを指定されたリストに追加する
{
  name: 'add_card_to_list',
  arguments: {
    listId: string,       // カードを追加するリストID
    name: string,         // カード名
    description?: string, // オプション：カードの説明
    due?: Date,          // オプション：期限日
    labels?: string[]     // オプション：ラベルIDの配列
  }
}

// 指定されたカードにコメントを追加する
{
  name: 'add_comment_to_card',
  arguments: {
    cardId: string, // カードID
    text: string     // コメントテキスト
  }
}

レート制限

デフォルトでは、Trello APIの無料プランでは以下の制限が適用されます。

• 1分間に20リクエスト
• 1時間に1000リクエスト

より高いレート制限が必要な場合は、有料プランへのアップグレードを検討してください。

エラーハンドリング

すべてのAPI呼び出しは、以下のフィールドを含むオブジェクトを返します。

{
  success: boolean,       // 操作が成功したかどうかを示すブール値
  data?: any,           // 成功時のレスポンスデータ
  error?: {
    message: string      // エラーメッセージ
  }
}

🔧 開発

リポジトリのクローン

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

依存関係のインストール

npm install

プロジェクトのビルド

npm run build

テストの実行

npm test

🤝 貢献

貢献を歓迎します！コード規約やプルリクエストの提出手順については、貢献ガイドをご覧ください。

📄 ライセンス

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

🙏 謝辞

• modelcontextprotocol SDKを使用して構築されています。
• Trello REST APIを使用しています。