MCP Server Trello

🚀 MCP サーバ - Trello

このサーバは、Model Context Protocol (MCP) を使用して Trello 看板との対話を可能にするツールです。Trello の API を統合する際に、自動的にレート制限、型安全性、エラー処理を行います。

✨ 主な機能

• Trello 看板の完全統合：カード、リスト、看板のアクティビティとの対話が可能です。
• 組み込みのレート制限：Trello の API 制限（API キーごとに 300 リクエスト/10 秒、トークンごとに 100 リクエスト/10 秒）を遵守します。
• 型安全な実装：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 API キー
        "TRELLO_TOKEN": "your-token",     // あなたの Trello トークン
        "TRELLO_BOARD_ID": "your-board-id" // 設定する Trello 看板 ID
      }
    }
  }
}

利用可能なツール

以下はサーバが提供する機能とその説明です。

💻 使用例

基本的な使用法

// 取得看板情報
// 指定看板の基本情報を取得
const board = await trello.getBoard(boardId);
// 戻り値：看板名、説明、メンバーなどの情報を含むオブジェクト

// 新しいリストを作成
// 指定看板上に新しいリストを作成
const newList = await trello.createList(boardId, "タスクリスト");

// カードをリストに追加
// 指定リストにカードを追加
const card = await trello.addCardToList(listId, "プロジェクトを完了する");

レート制限

サーバは、濫用を防止し、安定性を確保するために、1 分あたり最大 50 リクエストを処理します。

エラー処理

すべての API 呼び出しには、リトライ機能（最大 3 回）が付属しており、失敗時にはエラーログが記録されます。

開発情報

リポジトリのクローン

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

依存関係のインストール

npm install

プロジェクトのビルド

npm run build

テストの実行

npm test

貢献ガイド

貢献を歓迎します！コード規約と Pull Request の提出手順については、日本語貢献ガイド をご覧ください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されており、詳細は LICENSE ファイルに記載されています。

謝辞

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