Delorenj 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": "あなたのAPIキー", // https://trello.com/app-key から取得
        "TRELLO_TOKEN": "あなたのトークン",     // あなたのAPIキーを使用して生成
        "TRELLO_BOARD_ID": "あなたの看板ID"  // 看板URLで見つける
      }
    }
  }
}

必須の環境変数

• 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：リストIDに基づいてすべてのカードを取得します。

{
  name: 'get_cards_by_list_id',
  arguments: {
    listId: string // リストID
  }
}

• get_lists：設定された看板からすべてのリストを取得します。

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

• get_recent_activity：看板上の最近のアクティビティを取得します。

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

高度な使用法

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

{
  name: 'add_card_to_list',
  arguments: {
    listId: string, // リストID
    cardData: {
      idList: string,
      name: string,
      desc?: string,
      pos?: number,
      due?: string,
      dueComplete?: boolean,
      labels?: string[],
      members?: string[],
      comments?: {
        text: string
      }[]
    }
  }
}

• update_card：既存のカードの情報を更新します。

{
  name: 'update_card',
  arguments: {
    cardId: string, // カードID
    cardData: {
      idList?: string,
      name?: string,
      desc?: string,
      pos?: number,
      due?: string,
      dueComplete?: boolean,
      labels?: string[],
      members?: string[],
      comments?: {
        text: string
      }[]
    }
  }
}

• delete_card：指定されたカードを削除します。

{
  name: 'delete_card',
  arguments: {
    cardId: string // カードID
  }
}

レート制限

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

📄 ライセンス

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

貢献

貢献を歓迎します！コード規約とプルリクエストの提出プロセスについては、Contributing Guideを読んでください。