Server Trello MCP

🚀 MCP サーバー - 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 API キー（https://trello.com/app-key から取得）
        "TRELLO_TOKEN": "your-token",     // あなたの Trello トークン
        "TRELLO_BOARD_ID": "your-board-id" // あなたの Trello 看板 ID
      }
    }
  }
}

必要な環境変数

• TRELLO_API_KEY：あなたの Trello API キーで、Trello 開発者サイト から取得できます。
• TRELLO_TOKEN：認証に使用するトークンで、OAuth フローを通じて取得します。
• TRELLO_BOARD_ID：操作対象の Trello 看板の一意の識別子です。

利用可能なツール

以下はサーバーが提供する主な機能です。

基本的な使用法

1. 看板の作成

新しい Trello 看板を作成します。

mcp trello create-board --name "我的新看板"

• --name：看板の名前を指定します。

2. 看板の削除

指定された Trello 看板を削除します。

mcp trello delete-board --board-id "5a8b4e7a9d0ef356cccf17b"

• --board-id：削除する看板の一意の識別子です。

3. リストの作成

指定された看板に新しいリストを作成します。

mcp trello create-list --board-id "5a8b4e7a9d0ef356cccf17b" --name "待办事项"

• --board-id：対象の看板の一意の識別子です。
• --name：リストの名前を指定します。

4. リストの削除

指定された看板のリストを削除します。

mcp trello delete-list --list-id "5a8b4e7a9d0ef356cccf17c"

• --list-id：削除するリストの一意の識別子です。

5. カードの作成

指定されたリストの下に新しいカードを作成します。

mcp trello create-card --list-id "5a8b4e7a9d0ef356cccf17c" --name "完成项目"

• --list-id：対象のリストの一意の識別子です。
• --name：カードの名前を指定します。

6. カードの削除

指定されたリストの下のカードを削除します。

mcp trello delete-card --card-id "5a8b4e7a9d0ef356cccf17d"

• --card-id：削除するカードの一意の識別子です。

レート制限

このサーバーは Trello の API レート制限ポリシーを実装しています。

• 各 API キーは 10 秒間に最大 300 回のリクエストが許可されます。
• 各トークンは 10 秒間に最大 100 回のリクエストが許可されます。

制限を超えるリクエストは自動的にキューに入れられ、レート制限の影響を受けないようになっています。

エラー処理

サーバーは以下のエラー処理メカニズムを提供します。

• 入力検証エラー：入力パラメータが要件を満たさない場合、詳細な検証エラー情報を返します。
• API エラー：Trello API の呼び出しに失敗した場合、元のエラー情報を含む例外をキャッチして再スローします。
• ネットワークエラー：ネットワーク問題が発生した場合、エラーログを記録し、次の試行で再接続を試みます。

🔧 技術詳細

開発条件

1. Node.js と npm がシステムにインストールされていること。
2. TypeScript とコマンドラインツール開発に精通していること。

設定手順

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

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

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

npm install

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

npm run build

テストの実行

npm test

🤝 貢献ガイド

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

📄 ライセンス

このプロジェクトは MIT ライセンスを使用しており、詳細は LICENSE ファイルを参照してください。

🙏 謝辞

• モデルコンテキストプロトコル SDK を使用して構築されています。
• Trello REST API を採用しています。